国际短信
国际短信

 

查询短信发送结果

说明:

       支持 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、号码、发送时间、状态。