介绍
如果管理员设置用户账户需要状态报告,并且也配置了账户的状态报告接收地址,则用户可以接收到其发送短信的状态报告。用户侧启动一个HTTP服务用于接收状态报告
协议说明
用户通过HTTP的POST或GET方式接收上行短信
协议类目 |
说明 |
调用地址 |
http://pushMoUrl pushMoUrl为用户提供的推送地址 |
请求方式 |
POST,GET |
编码格式 |
UTF-8 |
Content-Type |
application/x-www-form-urlencoded;charset=utf-8 |
参数定义
参数 |
说明 |
receiver |
接收信息验证的用户名(不是账户名),是按照用户要求配置的名称,可以为空 |
pswd |
接收信息服务需验证的密码,可以为空 |
moTime |
格式YYMMDDhhmm,其中YY=年份的最后两位(00-99),MM=月份(01-12),DD=日(01-31),hh=小时(00-23),mm=分钟(00-59) |
mobile |
单一的手机号码 |
msg |
MO短信内容,文字内容使用UTF-8编码 |
destcode |
用户上行的目的号码(通道接入号 spCode + 账号扩展码 + 提交时的 extno) |
spCode |
通道接入号 |
isems |
是否为长短信的一部分,1:是,0,不是。不带该参数,默认为普通短信 |
emshead |
isems为1时,本参数以ASCII码形式显示长短信的头信息。用“,”隔开,分为三个部分,第一部分标识该条长短信的ID(该ID为短信中心生成);第二部分,表明该长短信的总条数(pk_total);第三部分,该条短信为该长短信的第几条(pk_number)。例如:234,4,1,234:该短信的ID为234,4:该长短信的总长度为4条,1:当前为第一条。 |
示例
普通短信:
1 2
| http://pushMoUrl?receiver=admin&pswd=12345&moTime=1208212205&destcode=1065751600001&spCode=10657516000&mobile=13800210021&msg=hello //其中,pushMoUrl为用户提供的推送地址
|
长短信:
1 2
| http://pushMoUrl?receiver=admin&pswd=12345&moTime=1208212205&mobile=13800210021&msg=hello)&isems=1&emshead=255,5,5 //其中,pushMoUrl为用户提供的推送地址
|
状态报告值
状态报告的值即,status后面的数据,详情查询状态报告值