介绍
如果管理员设置用户账户需要状态报告，并且也配置了账户的状态报告接收地址，则用户可以接收到其发送短信的状态报告。用户侧启动一个HTTP服务用于接收状态报告
协议说明
用户通过HTTP的POST或GET方式接收状态报告
| 协议类目 |
说明 |
| 调用地址 |
http://pushUrl pushUrl为用户提供的推送地址 |
| 请求方式 |
GET（单条推送），POST（批量推送） |
| 编码格式 |
UTF-8 |
| Content-Type |
application/x-www-form-urlencoded;charset=utf-8 |
状态报告单条推送 GET 方式
参数定义
| 参数 |
说明 |
| receiver |
接收状态报告验证的用户名（不是账户名），是按照用户要求配置的名称，可以为空 |
| pswd |
接收状态报告验证的密码，可以为空 |
| msgid |
提交短信时平台返回的msgid |
| reportTime |
格式YYMMDDhhmm，其中YY=年份的最后两位（00-99），MM=月份（01-12），DD=日（01-31），hh=小时（00-23），mm=分钟（00-59） |
| status |
状态报告数值 |
| rid |
客户发送短信时自行生成rid，状态报告推送时返回此参数 |
单条推送示例
1
| http://pushUrl?receiver=admin&pswd=12345&msgid=12345&reportTime=1012241002&mobile=13900210021&status=DELIVRD&rid=100011 //其中，pushUrl为用户提供的推送地址
|
状态报告批量推送 POST 方式
参数定义
| 参数 |
说明 |
| receiver |
接收状态报告验证的用户名（不是账户名），是按照用户要求配置的名称，可以为空 |
| pswd |
接收状态报告验证的密码，可以为空 |
| report |
多条状态报告用||分隔，每条状态中的字段用逗号分隔。字段含义参见状态报告单条推送， 格式为：msgid,reportTime,mobile,status||msgid,reportTime,mobile,status,rid |
批量推送示例
1
| http://pushUrl?receiver=admin&pswd=12345&report=1234567890,1012241002,13900210021,DELIVRD||1234567891,1012241002,13800210021,UNDELIV,100011 //其中，pushUrl为用户提供的推送地址
|
状态报告值
状态报告的值即 status 后面的数据，详情查询状态报告值