说明:
支持 http get 方式来查询短信发送状态,get 发送一次性最多提交 200 个号码。
查询的结果数据(HTTP 消息的body 段)是由一个或者多个字段组成的JSON 格式字符串。
HTTP 头参数“Content-Type”的值为“application/json;charset=utf-8”
参数 |
说明 |
是否必填 |
类型 |
version |
协议版本号 |
否(默认 1.0) |
String |
account |
帐号 |
是 |
String |
password |
1、服务器不加密时,则为明文密码 2、服务器加密时,则为 MD5 密码Md5 值 = md5 ( 用户名+ 明文密码 +seq+time+协商key) 协商的key 由服务端提供 |
是 |
String |
seq |
序列号,每次请求递增,初始值为 1 |
服务器要求加 密时必填 |
Int |
time |
请求发起的时间戳 |
服务器要求加 密时必填 |
Int |
ids |
指定查询发送结果的短信id(该 id 在提交时由系统返回),多个号码之间以英文逗号分隔(最多 200 个) |
是 |
String |
http://Ip:20003/getreport?account=***&password=***&ids=1,2
参数 |
说明 |
类型 |
status |
发送提交状态 |
INT |
success |
发送成功的条数 |
INT |
fail |
发送失败的条数 |
INT |
unsent |
未发送条数 |
|
sending |
正在发送的条数 |
|
nofound |
Id 没有找到的条数 |
|
array |
短信发送结果的数组 数组中依次包含“号码的状态查询 ID(数字)、号码(字符串)、发送时间(数字)、状态(数字)” 状态:0 发送成功,1:未发送,2:正在发送, 非 012 发送失败 |
|
备注:提交发送短信成功后,系统会给提供成功的号码生成一个 Id,以后客户可以根据这个 Id 来查询该短信的发送结果。
{"status":0, "success":1, "fail":1, "unsent":0, "sending":0, "nofound":0, "array":[[1,"10010",20171001123015,0], [2,"1008611",20171001123015,3]]}
备注:上述数组中的[1,10010,20171001123015,0],各个字段分别对应:号码的状态查询 ID、号码、发送时间、状态。