当前位置:个推文档 > 服务端 > RestAPI V2 (推荐使用) > 返回码说明
返回码说明
返回码说明
本文档主要介绍个推开放平台返回码
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 推送,推送次数超过每日推送总数限制,每日最多推送20次 |
403 |
30008 |
list推送次数超过每日推送总数限制,每日最多推送2000000次 |
403 |
30009 |
推送次数超过每日推送总数限制 |
403 |
30010 |
app/tag 推送次数超过每日推送总数限制,每日最多推送20次,和接口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 |
内部服务器错误 |
请求未到个推服务器,检查下本地网络情况,是否设置代理、白名单、防火墙等 |
反馈成功
非常感谢您的反馈,我们会继续努力做到更好!