状态报告查询

查询状态报告

建议使用 状态报告推送代替查询接口，即时性更好，效率更高，节约服务器资源

用户通过接口查询状态报告，查询频率建议3-5秒一次。返回格式为JSON格式，内容包含0条或多条状态报告

发送接口

协议说明

用户通过HTTP的POST、GET方式提交短信发送box

协议类目 说明
调用地址 http://IP:PORT/msg/QueryReport
请求方式 POST，GET
编码格式 UTF-8
Content-Type application/x-www-form-urlencoded;charset=utf-8

请求参数

参数 必填 说明
account 是 用户账号
ts 否 时间戳，格式yyyyMMddHHmmss
pswd 是 用户密码，ts参数为空时填明文密码，ts参数不为空时填md5(账号+密码+时间戳)，对账号密码时间戳拼接的字符串进行md5加密，小写32位

请求示例

1
http://IP:PORT/msg/QueryReport?account=111111&pswd=123456

json响应格式

提交成功示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
{
  "result": 0,                        //响应状态,0表示成功
  "mo": [                             //上行短信
    {
      "moTime": "1609220957",         //格式YYMMDDhhmm
      "destcode": "10690088123",      //用户上行的目的号码（通道接入号+提交时的extno）
      "mobile": "13524611927",        //单一的手机号码
      "spCode": "10690088",           //通道接入号
      "msg": "回复短信",               //MO短信内容，文字内容使用UTF-8编码
      "isems": "0",                   //是否为长短信的一部分，1:是，0，不是
      "emshead": ""                   //isems为1时，本参数以ASCII码形式显示长短信的头信息。
                                      //用“,”隔开，分为三个部分，第一部分标识该条长短信的ID
                                      //该ID为短信中心生成；
                                      //第二部分，表明该长短信的总条数（pk_total）；
                                      //第三部分，该条短信为该长短信的第几条(pk_number)。
                                      //例如：234,4,1，该短信的ID为234,该长短信的总长度为4条
                                      //1，表示当前为第一条。

    }
  ],
  "report": [                         //状态报告
    {
      "reportTime": "1609220957",     //格式YYMMDDhhmm
      "msgid": "1900922095721001300", //提交短信时平台返回的 msgid ,如果提交短信平台时使用了
                                      // rid，则值为发送接口提交时 rid 的值
      "status": "NOROUTE",            //状态报告，请查询状态报告值
      "mobile": "13524611927"         //单一的手机号码
    },
    {
      "reportTime": "1609220957",
      "msgid": "1900922095721001400",
      "status": "NOROUTE",
      "mobile": "13524611927"
    }
  ]
}

提交失败示例

1
2
3
4
5
{
    "result":101, //响应状态101表示失败,请查询状态码说明
    "report":[],  //状态报告为空
    "mo":[]       //上行短信为空
}

状态码返回

result 响应状态码查询状态码返回

状态报告值

status 状态报告的值查询状态报告值