https://xxxxxx/v4/timpush/push?usersig=xxx&identifier=admin&sdkappid=88888888&random=99999999&contenttype=json
参数 | 说明 |
https | 请求协议:HTTPS 请求方式:POST |
xxxxxx | SDKAppID 所在国家/地区对应的专属域名。 中国: console.tim.qq.com 新加坡: adminapisgp.im.qcloud.com 首尔: adminapikr.im.qcloud.com 法兰克福: adminapiger.im.qcloud.com 硅谷: adminapiusa.im.qcloud.com |
v4/timpush/push | 请求接口 |
usersig | |
identifier | 必须为 App 管理员账号 |
sdkappid | 创建应用时,即时通信控制台分配的 SdkAppid |
random | 32位无符号整数随机数 |
contenttype | 固定值为:json |
{"From_Account": "admin","MsgRandom": 3674128,"OnlineOnlyFlag": 0, // 0表示存漫游和未读,此时推送并发用户限制200人/秒;1表示不存漫游和未读,此时无推送并发限制"MsgBody": [{"MsgType": "TIMTextElem","MsgContent": {"Text": "hi, beauty"}}],"OfflinePushInfo": {"PushFlag": 0, // 0表示进行离线推送,1表示不进行离线推送"Title": "离线推送标题","Desc": "离线推送内容"}}
{"From_Account": "xiaoming","MsgRandom": 3674128,"OnlineOnlyFlag": 0, // 0表示存漫游和未读,此时推送并发用户限制200人/秒;1表示不存漫游和未读,此时无推送并发限制"MsgBody": [{"MsgType": "TIMTextElem","MsgContent": {"Text": "hi, beauty"}}],"OfflinePushInfo": {"PushFlag": 0, // 0表示进行离线推送,1表示不进行离线推送"Title": "离线推送标题","Desc": "离线推送内容"}}
{"From_Account": "xiaoming","MsgRandom": 3674128,"OnlineOnlyFlag": 1, // 0表示存漫游和未读,此时推送并发用户限制200人/秒;1表示不存漫游和未读,此时无推送并发限制"MsgBody": [{"MsgType": "TIMTextElem","MsgContent": {"Text": "hi, beauty"}}],"OfflinePushInfo": {"PushFlag": 1 // 0表示进行离线推送,1表示不进行离线推送}}
{"From_Account": "admin","MsgRandom": 124032,"OnlineOnlyFlag": 0, // 0表示存漫游和未读,此时推送并发用户限制200人/秒;1表示不存漫游和未读,此时无推送并发限制"Condition": {"TagsAnd": ["股票A","股票B"]},"MsgBody": [{"MsgType": "TIMTextElem","MsgContent": {"Text": "hi, beauty"}}],"OfflinePushInfo": {"PushFlag": 0, // 0表示进行离线推送,1表示不进行离线推送"Title": "离线推送标题","Desc": "离线推送内容"}}
{"From_Account": "admin","MsgRandom": 124032,"OnlineOnlyFlag": 0, // 0表示存漫游和未读,此时推送并发用户限制200人/秒;1表示不存漫游和未读,此时无推送并发限制"Condition": {"TagsOr": ["股票A","股票B"]},"MsgBody": [{"MsgType": "TIMTextElem","MsgContent": {"Text": "hi, beauty"}}],"OfflinePushInfo": {"PushFlag": 0, // 0表示进行离线推送,1表示不进行离线推送"Title": "离线推送标题","Desc": "离线推送内容"}}
{"From_Account": "admin","MsgRandom": 389475,"OnlineOnlyFlag": 0, // 0表示存漫游和未读,此时推送并发用户限制200人/秒;1表示不存漫游和未读,此时无推送并发限制"Condition": {"AttrsAnd": {"会员等级": "超白金会员","city": "深圳"}},"MsgBody": [{"MsgType": "TIMTextElem","MsgContent": {"Text": "hi, beauty"}}],"OfflinePushInfo": {"PushFlag": 0, // 0表示进行离线推送,1表示不进行离线推送"Title": "离线推送标题","Desc": "离线推送内容"}}
{"From_Account": "admin","MsgRandom": 389475,"OnlineOnlyFlag": 0, // 0表示存漫游和未读,此时推送并发用户限制200人/秒;1表示不存漫游和未读,此时无推送并发限制"Condition": {"AttrsAnd": {"会员等级": "超白金用户","city": "深圳"}},"MsgBody": [{"MsgType": "TIMTextElem","MsgContent": {"Text": "hi, beauty"}}],"OfflinePushInfo": {"PushFlag": 0, // 0表示进行离线推送,1表示不进行离线推送"Title": "离线推送标题","Desc": "离线推送内容"}}
字段 | 类型 | 属性 | 说明 |
From_Account | String | 选填 | 消息推送方账号(支持指定为任意存在的账号) 注意:如果未指定发送方或指定的发送方不存在,则默认取接口调用方账号。 |
MsgRandom | Integer | 必填 | 消息随机数(32位无符号整数),后台用于同一秒内的消息去重。请确保该字段填的是随机 |
OnlineOnlyFlag | Integer | 选填 | 默认为 0,表示存漫游和未读,此时推送并发用户限制200人/秒。 1 表示不存历史消息且不计未读,此时无推送并发限制。 |
Condition | Object | 选填 | Condition 共有4种条件类型,分别是: 属性的 “或条件” AttrsOr 属性的 “与条件” AttrsAnd 标签的 “或条件” TagsOr 标签的 “与条件” TagsAnd 注意:AttrsOr 、 AttrsAnd 、TagsOr 、TagsAnd 不能并存。如果没有 Condition,则推送给全部用户。 |
TagsOr | Array | 选填 | 标签条件的并集。标签是一个不超过50字节的字符串。 注意:属性推送和标签推送不可同时作为推送条件。TagsOr 条件中的标签个数不超过10个。 |
TagsAnd | Array | 选填 | 标签条件的交集。标签是一个不超过50字节的字符串。 注意:属性推送和标签推送不可同时作为推送条件。TagsAnd 条件中的标签个数不超过10个。 |
AttrsOr | Object | 选填 | 属性条件的并集。 注意:属性推送和标签推送不可同时作为推送条件。 |
AttrsAnd | Object | 选填 | 属性条件的交集。 注意:属性推送和标签推送不可同时作为推送条件。 |
MsgBody | Array | 必填 | |
MsgType | String | 必填 | TIM 消息对象类型,目前支持的消息对象包括: TIMTextElem(文本消息) TIMLocationElem(位置消息) TIMFaceElem(表情消息) TIMCustomElem(自定义消息) TIMSoundElem(语音消息) TIMImageElem(图像消息) TIMFileElem(文件消息) TIMVideoFileElem(视频消息) |
MsgContent | Object | 必填 | |
OfflinePushInfo | Object | 选填 |
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0,"TaskId": "53743040_144115212910570789_4155518400_15723514"}
字段 | 类型 | 说明 |
ActionStatus | String | 请求处理的结果: OK:表示处理成功 FAIL:表示失败 |
ErrorCode | Integer | 错误码 |
ErrorInfo | String | 错误信息 |
TaskId | String | 推送任务 ID |
错误码 | 含义说明 |
90001 | JSON 格式解析失败,请检查请求包是否符合 JSON 规范。 |
90002 | |
90005 | JSON 格式请求包体中缺少 MsgRandom 字段或者 MsgRandom 字段不是 Integer 类型。 |
90007 | JSON 格式请求包体中 MsgBody 类型不是 Array 类型,请将其修改为 Array 类型。 |
90009 | 请求需要 App 管理员权限。 |
90010 | |
90020 | 标签长度超过限制(不能超过50字节)。 |
90022 | 推送条件中的 TagsOr 和 TagsAnd 有重复标签。 |
90024 | 推送过于频繁,每两次推送间隔必须大于1秒。 |
90026 | 消息离线存储时间错误(最多不能超过7天)。 |
90032 | 推送条件中的 tag 数量大于10,或添加标签请求中的标签数量大于10。 |
90033 | 属性无效。 |
90039 | 按属性推送和按标签推送不可同时存在。 |
90040 | 推送条件中其中1个 tag 为空。 |
90045 | 未开通全员/标签推送功能。 |
90047 | 推送次数超过当天限额(默认为100次)。 |
91000 | 服务内部错误,请重试。 |
本页内容是否解决了您的问题?