状态报告推送

介绍

如果管理员设置用户账户需要状态报告,并且也配置了账户的状态报告接收地址,则用户可以接收到其发送短信的状态报告。用户侧启动一个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 后面的数据,详情查询状态报告值