其他错误码列表 Android 点我;iOS 点我;服务端 点我


含义:参数值不合法

注:近期极光在迁移应用至北京机房,在原服务器端我们对错误的写法做了一些兼容,在新版本服务器将不再做兼容,可能会出现之前调 API 成功现在报错的情况,请务必阅读文档说明严格遵循参数的类型和传值要求!

可能的错误原因:

  • 类型不正确,各字段必须严格遵循文档的类型要求,如果自己排查不出原因,打开官方的 log,或断点调试,提供最后所传输的 json 数据给官方人员(在社区发帖)协助分析。

  • audience 非法,该问题常出现在 audience 传具体的 tag、alias、registrationID 等值时,仿照 "all" 的写法传为了字符串(错误写法),请注意在这种情况下传值的大括号前后不要有双引号,参考示例说明

  • sendno 类型不正确、越界。规定范围:(1-4294967295) ,int 类型

  • appkey 不存在,Appkey 未传值,或传值错误(Appkey 在官网应用信息处,不是账户信息中的 DevKey)

  • tags 推送最多支持 20 个、alias 推送最多支持 1000 个、registration_id 推送最多支持 1000 个、tag/ailas 长度不能超过 40 字节

  • tag/alias 、registration_id 值不合法

    • 有效的 tag 、alias 组成:字母(区分大小写)、数字、下划线、汉字、特殊字符@!#$&*+=.|¥

    • 有效的 RegistrationID 长度为 11 或 19 个字节,其中第一位有效字符 [0,1],第二位有效字符 [0-9a],第三位有效字符 [0-2],剩余位有效字符 [0-9a-f]。registrationID 只能在客户端集成后取到,不可以自行在服务端生成。

  • builder_id 必须为 1~1000 之间的数,int 类型。

  • time_to_live 是 int 类型,必须大于等于 0 ,最长可设置 10 天,即 864000,在范围外的值将报错。

  • apns_production : Boolean 类型,请传 false 或者 true ,不要传 0 或 1,也注意不要传成了字符串。

  • override_msg_id 不存在,如果你不需要覆盖功能,请去掉该字段,详细说明

    • 覆盖功能起作用的时限是:1 天。如果在覆盖指定时限内该 msg_id 不存在,则返回 1003 错误

    • 如果你使用的是某语言的 SDK ,在去掉该字段后仍有默认的值且不正确,请在源码中找到默认设置删除或者升级你的 SDK 版本。



如果对你有帮助,点个赞 呗ლ(╹◡╹ლ)

点这里返回常见问题目录,不吹不黑,收藏本帖可以解决你 90% 的问题 (ノ◕ω◕)ノଘ_ଘ