文档中心 登录/注册 SDK下载 个推学堂

当前位置：个推文档 > 服务端 > 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 {param} cannot be null 参数不能为空 请检查参数 400
20001 {param} type error 参数类型错误 请检查参数 400
20001 {param} size over limit 参数长度超限 请检查参数 400
20001 target user is invalid cid无效或者错误或者cid不是当前应用的 400
20001 contains duplicate {param} 数据重复，一般是cid/alias重复 400
20001 {param} cannot be repeat. 参数不能重复 400
20001 please choose one of notification and transmission and revoke notification、transmission、revoke参数只能使用一个 400
20001 choose one of {param1} and {param2} 参数二选一，不能都填 400
20001 {param1} and {param2} cannot be null at sametime 参数不能同时为空 400
20001 {param1} and {param2} cannot setting at same time 参数二选一，不能都填 400
20001 {param} must be JsonString 参数必须是jsonString 400
20001 permission required by {function} 没有开通对应功能的权限 400
20001 {param} maxlength should <= {length} 字段长度超长 400
20001 no permission to push with third classification 不允许使用消息分类 400
20001 ios长度不能超过{length} 字段长度问题 400
20001 wx:所需下发的订阅模板id不能为空 ios参数长度超限 400
20001 wx:跳转小程序类型错误 跳转小程序类型错误 400
20001 wx:语言类型错误 语言类型错误 400
20001 wx:模板参数{param}的内容不能为空 参数不能为空 400
20001 wx:模板参数{param}的内容长度超限 参数长度超限 400
20001 模板参数{param}的内容不满足规则 参数内容不满足规则 400
20001 this app is not allow to use active_push 应用没有亮屏推送权限 400
20001 active_push can not set ttl equals or less than 0 亮屏推送的ttl不能小于0 400
20001 active_push can not set lst equals or less than 0 亮屏推送lst不能小于0 400
20001 active_push can not set lst equals or larger than ttl 亮屏推送lst不能大于ttl 400
20001 active_push must use android notification 亮屏推送，必须设置android notification 400
20001 push_message old_task_id and push_channel old_task_id must equal when revoke both 同时撤回多个通道消息时，需要撤回的taskId必须一致 400
20001 want must have a non null want不能为空 400
20001 portrait标签范围错误，请填写正确的标签，错误标签: {tag} 标签错误 400
20001 taskId cannot be empty or null 任务id不能为空 400
20001 please choose one of {params} 以上参数只能选填一个 400
20001 {params} cannot all be null 以上参数不能都为空 400
20001 group push can not revoke single old_task_id 群推不能撤销单推任务 400
22001 scheduled task has been executed and cannot be deleted 定时任务已经执行，无法删除 400
22002 scheduled task time is invalid 任务无效或定时任务时间不合法 400
22002 read request timeout 读消息体超时 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
30020 无权限查询设备状态 403
30021 查询设备状态被限频 403
30022 系统繁忙，稍后再试 403
30023 没有推送余量查询权限 403
30024 没有查询任务时间接口权限 403

5000 - 网络相关

code 错误描述 解决措施
5000 内部服务器错误 请求未到个推服务器，检查下本地网络情况，是否设置代理、白名单、防火墙等
在这篇文章中： HTTP code码说明 业务返回码说明
开发者中心 SDK 下载

文档中心搜索

技术
咨询

微信扫一扫

随时联系技术支持

在线
咨询