文档中心
开发者中心
SDK下载
请选择产品
个推·消息推送
个数·应用统计
个像·用户画像
个推·短信服务
个验·验证服务
实人认证
变现服务
鲸智运营中心
快速入门
产品简介
开发者中心使用说明
进阶功能
名词解释
AppLink配置说明书
多厂商推送接入说明
客户端
Android
概述
3分钟演示
集成指南
API接口
进阶功能
AppLink集成
Maven集成视频
iOS
概述
3分钟演示
集成指南
API接口
AppLink集成
iOS 证书配置指南
iOS集成视频
多厂商
厂商应用开通指南
厂商SDK集成指南
厂商消息报表补全
厂商SDK更新日志
OTT
概述
3分钟演示
Android Studio标准集成
AppLink 集成
API接口文档
客户端插件
服务端
RestAPI V2
开发前必读
接口调用规范
进阶功能说明
公共参数
多厂商参数
鉴权API
推送API
统计API
用户API
返回码说明
服务端 SDK
老版文档
导航
常见问题
Android常见问题
iOS常见问题
服务端常见问题
SDK权限配置说明
多厂商常见问题
其他常见问题
SDK更新日志
当前位置:个推文档 > 常见问题 > 服务端常见问题
服务端常见问题
服务端常见问题
1. 服务端接口推送返回 appid_error
Appid_error表示推送指定的appid和clientid绑定的appid不一致
原因应该您修改过应用appid,导致clientid绑定在之前的appid上,你需要的操作:删除sd卡libs目录,应用清除数据或者卸载重装,再启动应用重新获取clientid
2. 服务端接口推送返回 tokenMD5noUser
clientID输入错误,或者是个无效的clientID(clientID无效,意味着用户3个月未登陆)
3. 服务端接口推送返回 appidNoUser
客户端还未集成sdk,或者集成后未获取到clientID,导致服务端任务该appid下没有用户
查看服务端是否写错APPID
查看客户端配置文件中配置的APPID和服务端配置的是否一致。
4. 服务端接口推送返回 DuplicatedContentId
第三方服务端推送消息,个推服务端接收到消息,但是发送的回执第三方服务端没有收到而超时导致服务端SDK再次发送,个推服务端会再次接收到,但不会再次下发的,会返回错误信息给第三方服务端。
5. 服务端接口推送返回 sign_error
请确认编码是否是UTF-8,不是则修改为UTF-8
检测APPID,APPKEY,MASTERSECRET相关的值,尤其MASTERSECRET不要与APPSECRET搞混。
服务端出口ip是否有多个,若无法固定出口ip,可使用restAPI或者使用Java最新版本的SDK。
6. 服务端调用API接口返回值是成功的,但客户端没有接收到
如{taskId=OSS-052X_VuS4
***
M5KgDQ4, result=ok, status=successed_online},这样的返回值中,result=ok,是说明已经成功提交到个推服务端。
status=successed_online,status有三种状态:online,offline,ignore,分别是在线下发,离线下发,无效用户三种状态。
先确认客户端和服务端配置的APPID等参数信息是否一致,一致的话把clientid提供给技术支持人员,让他们协助排查。
如果推送的透传消息,在客户端是没有任何提示的,透传消息个推SDK接收到后直接广播给客户端,不做任何处理,需要客户端自己去处理。确认客户端是否有对透传消息进行处理。
推送给iOS应用的消息,如果是online状态,则是用个推通道推送的透传消息,如果是offline状态则是用APN通道推送的,会有通知栏消息提示的,消息接收不及时有可能是APN延迟导致的。
7. 其他常见服务端问题
(1)novalidpush的问题
推送的列表里所有clientid全部无效或者全部推送失败,会返回这个错误
(2)taskgrouperror
报这个错,主要是任务组名太长,或者格式不对。
有效taskGroupName为:字母(大小写都可)、数字、下划线、汉字
taskGroupName的utf8最大字节为40
(3)api推送返回成功了,为什么api上看不到推送记录
API推送,如果是tosingle接口推送的,平台上是不记录的,只有tolist(推送的clientID大于等于2个)和toapp接口推送的才会记录。并且这个接口推送的记录不实时统计的,隔天将在平台上看到统计数据。
(4)推送接口中离线和离线时间的设置有什么作用
针对Android用户,设置了离线和离线时间,当推送任务下发后,检测到要推送的用户处于离线状态,会先将该消息存在离线库里,当用户在设置的离线时间内在线,离线消息将会下发。
针对iOS的离线用户,会直接向苹果APNs发起请求。
在这篇文章中:
1. 服务端接口推送返回 appid_error
2. 服务端接口推送返回 tokenMD5noUser
3. 服务端接口推送返回 appidNoUser
4. 服务端接口推送返回 DuplicatedContentId
5. 服务端接口推送返回 sign_error
6. 服务端调用API接口返回值是成功的,但客户端没有接收到
7. 其他常见服务端问题
开发者中心
SDK 下载
文档中心搜索
搜 索