状态报告推送
提供推送回调URL
- 客户需要提供状态反馈推送的URL
推送方式
- content-type : application/json;charset=UTF-8
- POST
- raw方式
推送参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| status | 是 | int | 提交响应状态 |
| result | 是 | JSON Array | 状态反馈信息（打包数组) |
result参数说明
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| phone | 是 | string | 手机号码 |
| msgid | 是 | string | 与提交中的MsgId 一致 |
| status | 是 | string | 短信状态 |
| donetime | 是 | string | 短信到达时间 |
推送示例
{
"status" : 0, // 固定值0
"result" :
[
{
"phone" : "13921350591", // 手机号码
"msgid" : "-8629637681836384963", // 与提交中的MsgId 一致
"status" : "DELIVRD" , // 短信状态，参考附表2
"donetime" : "20170816153922" // 短信到达时间，格式 yyyyMMddHHmmss
}
//这里是数组会有多条，默认最大500条
]
}
响应示例
0
注意事项
- 每个账号最大推送频率为10次/秒，每次推送包含最小1个、最大500个状态报告
- 客户接收数据后需要返回数字0（不是JSON结构），表示状态接收成功
- 如返回的是非数字0，平台会把客户账号标记为异常，暂停向该账号推送新的状态报告，并且每隔1分钟重推一次原状态报告；如连续推送10次都没有返回数字0，推送间隔改为5分钟重试一次，直到客户返回数字0才恢复正常推送
- 由于并发和网络情况，可能会发生短信提交接口还未返回，状态报告先推送回来的情况，都为过滤失败的状态，接入时需要注意