主动推送回执接口(JSON 格式)
功能描述:
- 由短信平台主动向客户指定的回调 URL 推送短信发送状态回执,无需客户轮询查询。
调用格式:
- 请求方式:POST(由平台发起,客户需预先提供可公网访问的接收地址)
HTTP 头:
Content-Type: application/json; charset=UTF-8
请求示例:
json
{
"reports": [
{
"mobile": "13812345678",
"result": "0",
"taskid": "211119121329715277",
"stat": "DELIVRD",
"num": "0",
"report_time": "2014-01-01 16:37:31",
"sn": ""
},
{
"mobile": "13912345678",
"result": "1",
"taskid": "211119121329715277",
"stat": "DB:0006",
"num": "0",
"report_time": "2014-01-01 10:15:26",
"sn": ""
}
]
}请求参数:
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| reports | JSONArray | 是 | 回执数据数组 |
客户响应要求:
- 成功接收后,客户服务端必须返回以下任意一种响应内容(纯文本):
0succ
- 若未按要求返回,平台可能进行重试推送。
响应字段说明:
| 字段 | 描述 |
|---|---|
| taskid | 任务编号(对应发送接口返回的 taskid) |
| mobile | 接收短信的手机号码 |
| result | 回执结果,0 表示成功,非 0 表示失败 |
| stat | 回执状态码(如 DELIVRD 表示成功) |
| sn | 流水号(若发送时未填写,则为空字符串) |
| report_time | 回执时间,格式:yyyy-MM-dd HH:mm:ss |
| num | 长短信分片序号,从 0 开始 |
💡 提示:请确保回调地址稳定、支持 POST 请求,并能正确解析 UTF-8 编码的 JSON 数据体。