产品动态
公告
https://xxxxxx/v4/timpush/normal_push_trace?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
参数 | 说明 |
xxxxxx | SDKAppID 所在国家/地区对应的专属域名。 中国： console.tim.qq.com新加坡： adminapisgp.im.qcloud.com首尔： adminapikr.im.qcloud.com法兰克福： adminapiger.im.qcloud.com硅谷： adminapiusa.im.qcloud.com雅加达： adminapiidn.im.qcloud.com |
v4/timpush/normal_push_trace | 请求接口 |
sdkappid | 创建应用时即时通信 IM 控制台分配的 SDKAppID |
identifier | |
usersig | |
random | 请输入随机的32位无符号整数，取值范围0 - 4294967295 |
contenttype | 请求格式固定值为 json |
{"PushID":"xxx-yyy-zzz"}
字段 | 类型 | 属性 | 说明 |
PushID | String | 必填 | 推送消息对应的MsgID。 |
{"ActionStatus": "OK","ErrorCode": 0,"ErrorInfo": "sucess","InstanceTrace": [{"InstanceId": "101205908","PushTime": "2025-03-07 10:04:47","DeviceModel": "","System": "APNS","SystemVersion": "","PushPlatform": 1,"Token": "","CertId": "0","SdkVersion": "","PushVersion": "","NotificationStatus": 0,"last_active_terminal": 1,"IMCommitStat": {"IMStat": {"PushStatus": 1,"ErrorCode": 0,"ErrorInfo": "success","EventTime": "2025-03-07 10:04:47"}},"OfflinePushStat": {"OfflineStat": {"PushStatus": 1,"ErrorCode": 0,"ErrorInfo": "success","EventTime": "2025-03-13 16:16:29"},"ChannelStat": {"PushStatus": 1,"ErrorCode": 0,"ErrorInfo": "success","EventTime": "2025-03-13 16:16:29"},"DeviceStat": {"PushStatus": 1,"ErrorCode": 0,"ErrorInfo": "success","EventTime": "2025-03-13 16:16:29"},"ClickStat": {"PushStatus": 1,"ErrorCode": 0,"ErrorInfo": "success","EventTime": "2025-03-13 16:16:29"}}}]}
字段 | 类型 | 说明 |
ActionStatus | String | 请求处理的结果，OK 表示处理成功，FAIL 表示失败。 |
ErrorCode | Integer | 错误码，0表示成功，非0表示失败。 |
ErrorInfo | String | 错误信息。 |
InstanceTrace | Array | 各个IM实例推送相关的链路数据整理。 |
InstanceId | String | IM实例标识。 |
PushTime | String | 推送任务时间。 |
DeviceModel | String | 设备型号。 |
System | String | 设备系统。 |
SystemVersion | String | 设备系统版本。 |
PushPlatform | Integer | 推送厂商（在线推送 EventType = 2不区分厂商，默认返回0），取值范围：0-8。 0：未知厂商 1：Apple APNS 2：小米 3：华为 4：Google FCM 5：魅族 6：OPPO 7：vivo 8：荣耀 |
Token | String | 厂商Token。 |
CertId | String | 证书ID。 |
SdkVersion | String | SDK版本号。 |
PushVersion | String | 推送插件版本号。 |
NotificationStatus | Integer | 通知栏状态是否开启。 |
LastActiveTerminal | Integer | 是否是最近激活的IM实例。 |
IMCommitStat | Object | 提交IM服务器的状态。 |
IMStat | Object | IM的状态。 |
OfflinePushStat | Object | 离线通道的状态。 |
OfflineStat | Object | 提交离线通道的状态。 |
ChannelStat | Object | 提交厂商通道的状态。 |
DeviceStat | Object | 消息推送至设备的状态。 |
ClickStat | Object | 用户点击的状态。 |
OnlinePushStat | Object | 在线通道的状态。 |
ChannelStat | Object | 提交厂商通道的状态。 |
DeviceStat | Object | 消息推送至设备的状态。 |
PushStatus | Integer | 成功或者失败，1表示成功，2表示失败。 |
ErrorCode | Integer | 失败对应的错误码。 |
ErrorInfo | String | 错误描述。 |
EventTime | String | 事件发送时间。 |
错误码 | 描述 |
91000 | 请求错误，请根据错误提示排查问题。 |
90009 | 请求缺少权限，请使用管理员调用。 |
90045 | 服务没有开通，请确保服务开启使用。 |
90100 | 请求参数无效，请根据文档检查参数是否合法。 |
90102 | 请求内部错误，请稍后重试。 |
90103 | 换账号失败，请检查UserID是否合法。 |
文档反馈