状态报告
更新时间:2026-09-15 17:21:56
一、状态报告推送
说明
接收方 http 类型为 post,数据类型为 json数组,返回 "ok" (注意:直接返回字符串 ok)
推送参数
| 字段 | 数据类型 | 描述 |
|---|---|---|
| submitNo | string | 提交号 |
| phone | string | 手机号码 |
| createTime | long | 状态报告返回时间 |
| batchId | string | 批次号 |
| deliveryStatus | string | 1 成功 2 失败 |
| clErrorCode | string | 错误代码 |
| accountId | string | 用户编号 该字段已无效 |
| msgId | string | 当前消息唯一标识 该字段已无效 |
注意事项:对方接收到状态报告后需要返回:
"ok"
批量推送格式
[ { "accountId": "208458", "batchId": "1353610635174481920", "clErrorCode": "CL_1000", "createTime": 1611560900063, "deliveryStatus": "2", "msgId": "172372892338618368", "phone": "156********", "submitNo": "20845820210125154818660" }, { "accountId": "208458", "batchId": "1353610635174481920", "clErrorCode": "CL_1000", "createTime": 1611560900090, "deliveryStatus": "2", "msgId": "172372892435087360", "phone": "159********", "submitNo": "20845820210125154818660" } ]
二、状态报告拉取
说明
状态报告通知方式默认为推送,此接口需要联系运营开启(需提供出口 ip)。
开通此接口功能后,状态报告保存时间为 72 小时;数据拉取成功后服务器会删除当前拉取成功的数据,不再保存!请用户及时存储。
方法
- 请求方法: POST
- Content-Type:application/json; charset=utf-8
- 请求网址:https://rcs.253.com/rcs/api/v2/report/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 | 返回数据 |
| --> phone | string | 手机号码 |
| --> batchId | string | 批次号 |
| --> submitNo | string | 提交号 |
| --> deliveryStatus | string | 状态:1 成功,2 失败 |
| --> createTime | long | 状态报告返回时间(时间戳) |
| --> clErrorCode | string | 错误代码 |
示例
请求:
{ "appId": "aaaaaaaaaaa", "timestamp": "1656036438", "signature": "xxxxxxxxxxxxxxxxxxxx" }
响应:
{ "code": "102000", "message": "请求成功", "data": [ { "phone": "18717950159", "batchId": "1111111111111", "submitNo": "2222222222222", "deliveryStatus": "1", "createTime": 1656036261113, "clErrorCode": "CL_0000" }, { "phone": "18912345678", "batchId": "3333333333333", "submitNo": "44444444444", "deliveryStatus": "1", "createTime": 1656036261115, "clErrorCode": "CL_0000" } ] }
这篇文档对您有帮助吗?




