状态报告
更新时间：2026-07-29 20:44:03
一、状态报告推送
说明
接收方 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<Object> | 返回数据 |
| ├─ 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"
}
]
}这篇文档对您有帮助吗？
