上行消息
更新时间:2026-09-15 17:22:03
一、上行消息推送
说明
接收方 http 类型为 post,数据类型为 json,返回 "ok" (注意:直接返回字符串 ok)
推送参数
| 字段 | 数据类型 | 描述 |
|---|---|---|
| accountId | string | 用户 id 该字段已无效 |
| codeNo | string | 拓展码 该字段已无效 |
| codeNoAddress | long | 完整拓展码 |
| createTime | string | 上行时间 |
| msgId | string | 消息 id |
| phone | string | 手机号 |
| upContent | string | 上行内容 |
| batchId | string | 批次号 |
| submitNo | string | 提交号 |
注意事项:对方接收到上行消息后需要返回:
"ok"
推送格式
[ { "accountId": "167475", "codeNo": "0004", "codeNoAddress": "1065086140390004", "createTime": 1606745282003, "msgId": "173579743935856640", "phone": "18717950159", "upContent": "好的,来自晓白", "batchId": "1412651215151221", "submitNo": "637e904rd9hf" } ]
二、上行消息拉取
说明
上行消息通知方式默认为推送,此接口需要联系运营开启(需提供出口 ip)。
开通此接口功能后,上行保存时间为 72 小时;数据拉取成功后服务器会删除当前拉取成功的数据,不再保存!请用户及时存储。
方法
- 请求方法: POST
- Content-Type:application/json; charset=utf-8
- 请求网址:https://rcs.253.com/rcs/api/v2/reply/pull
参数
| 字段 | 数据类型 | 可选属性 | 描述 |
|---|---|---|---|
| appId | string | M | 发送账号 |
| num | number | O | 拉取个数(上限 100,默认 20) |
| timestamp | string | M | 时间戳,1970/1/1 到现在的秒数,10 位 200 秒内请求有效 |
| signature | string | M | 签名 |
返回值
| 字段 | 类型 | 说明 |
|---|---|---|
| code | string | 返回码 |
| message | string | 错误描述 |
| data | List | 返回数据 |
| --> codeNoAddress | string | 完整拓展码 |
| --> msgId | string | 消息 ID |
| --> createTime | long | 上行时间(时间戳) |
| --> phone | string | 手机号 |
| --> upContent | string | 上行内容 |
| --> batchId | string | 批次号 |
| --> submitNo | string | 提交号 |
示例
请求:
{ "appId": "aaaaaaaaaaa", "timestamp": "1656036438", "signature": "xxxxxxxxxxxxxxxxxxxx" }
响应:
{ "code": "102000", "message": "请求成功", "data": [ { "phone": "18717950159", "codeNoAddress": "1111111111111", "msgId": "2222222222222", "upContent": "1", "createTime": 1656036261113, "batchId": "1412651215151221", "submitNo": "637e904rd9hf" } ] }
这篇文档对您有帮助吗?




