返回码说明

返回码说明

本文档主要介绍个推开放平台返回码

HTTP code码说明

code 错误描述 解决措施
200 成功 查看基础返回码
400 参数错误 具体异常信息请参考业务返回码
401 权限相关 具体异常信息请参考业务返回码
403 套餐相关 具体异常信息请参考业务返回码
404 url错误 请检查Http路径是否正确
405 方法不支持 该接口不支持该方法请求,请查看文档确认请求方式

业务返回码说明

基础返回码

code 错误描述 解决措施 对应http code
0 成功 不涉及 200
1 失败 接口入参要求是 json 格式,非 json 格式会无法识别导致报错,建议检查一下代码 200
2 服务正在启动 请等待 200
301 域名错误 请检查域名是否与appid机房匹配 200
404 url错误 请检查Http路径是否正确 404
405 方法不支持 该接口不支持该方法请求,请查看文档确认请求方式 405

10000 - 权限相关

code 错误描述 解决措施 对应http code
10001 token错误/失效 调用接口重新获取token 401
10002 appId或ip在黑名单中 401
10003 每分钟鉴权频率超限 接口调用过于频繁 401
10004 没有查询消息明细的权限 可以申请权限,若有需要,请点击右侧“技术咨询”了解详情 401
10005 每分钟调用频率超限 401

20000 - 参数相关

code msg 错误描述 解决措施 对应http code
20001 {param} is invalid 参数不合法 请检查参数 400
20001 {param} can not be empty 参数不能为空 请检查参数 400
20001 target user is invalid cid无效或者错误或者cid不是当前应用的 400
20001 contains duplicate {param} 数据重复,一般是cid/alias重复 400
20001 please choose one of notification and transmission and revoke notification、transmission、revoke参数只能使用一个 400
22001 scheduled task has been executed and cannot be deleted 定时任务已经执行,无法删除 400
22002 scheduled task time is invalid 任务无效或定时任务时间不合法 400
23001 failed to modifytag 操作tag失败 400

30000 - 套餐相关,关于套餐相关的返回码,可以针对应用特殊配置,若有需要,请点击右侧“技术咨询”了解详情。

code 错误描述 对应http code
30000 没有推送fast_custom_tag的权限 403
30001 没有修改和删除custom_tag的权限 403
30002 没有推送定时任务的权限 403
30003 app/tag 接口无权限,或tag无效 403
30004 tag每日推送总数超限(VIP用户可根据应用特殊配置) 403
30005 tag长度超限(tag长度<32字) 403
30006 fast_custom_tag次数超过每日推送总数限制(VIP用户可根据应用特殊配置) 403
30007 app/all推送,推送次数超过每日推送总数限制,每日最多推送100次 403
30008 list推送次数超过每日推送总数限制,每日最多推送2000000次 403
30009 推送次数超过每日推送总数限制 403
30010 app/tag 推送次数超过每日推送总数限制,每日最多推送100次,和接口app/all共享限制 403
30011 设置tag次数超过每日次数限制 403
30012 修改和删除tag 超过每分钟频率限制,每分钟最多操作5次 403
30013 推送fast_custom_tag频率超过每分钟频率限制(VIP用户可根据应用特殊配置) 403
30014 app 推送 频率超过每分钟频率限制,每分钟最多操作5次 403
30015 list推送 频率超过每分钟频率限制 403
30016 push/tag tag个数超过限制 403
30017 没有查询单推实时报表的权限 403
30018 查询单推实时报表 频率超过每分钟频率限制 403
30019 系统繁忙,请稍后重试 403

5000 - 网络相关

code 错误描述 解决措施
5000 内部服务器错误 请求未到个推服务器,检查下本地网络情况,是否设置代理、白名单、防火墙等
开发者中心 SDK 下载

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持

在线
咨询