上行消息

一、上行消息推送

说明

接收方 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<Object>	返回数据
├─ 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"
    }
  ]
}

产品中心

热门搜索

中国站

国际站

一、上行消息推送

说明

推送参数

推送格式

二、上行消息拉取

说明

方法

参数

返回值

示例