通过接口,可以查询到一个或者多个订单的发送状态信息。
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| account | √ | string | 参考:短信HTTP 接口对接总览 |
| token | √ | string | 参考:短信HTTP 接口对接总览 |
| ts | √ | string | 参考:短信HTTP 接口对接总览 |
| orderIds | √ | string | 可以一次查询一个订单或者多个订单,多个订单号用半角字符“,”分开 |
{
"code":0,
"msg":"查询成功",
"total":2,
"reports":
[
{
"order_id":"1839347820929302091",
"mobile":"18600000001",
"status":0,
"msg":"信息提示",
"time":"2016-12-22 23:11:40",
"pieces":1,
"ext":"123",
"ref":"",
"account":"10000a"
},
{
"order_id":"1839347820929302093",
"mobile":"18600000000",
"status":0,
"msg":"信息提示",
"time":"2016-12-22 23:11:40",
"pieces":1,
"ext":"123",
"ref":"",
"account":"10000a"
}
]
}
| 变量名 | 必返 | 类型 | 含义 |
|---|---|---|---|
| code | √ | int | 0代表成功,负数代表失败 |
| msg | √ | string | code状态对应的中文解释 |
| total | √ | int | 代表本次收到多少个短信发送请求,数量会和mobiles的手机号数量一致 |
| reports | √ | array | 状态的汇报信息是一个数组,会对每一个手机号码的下发请求做单独的汇报 |
| reports.order_id | √ | string | 短信提交成功后的订单id |
| reports.mobile | √ | string | 订单对应下发的目标手机号码 账号开启加密后手机号则为加密后的密文。 |
| reports.status | √ | int | 状态报告: 负数代表平台驳回,详见错误代码对应表 0代表平台收到消息,还在处理 1代表最终发送成功 2代表测试状态模拟成功 3代表正在发送中(未回状态) 大于3代表运营商反馈发送失败 |
| reports.msg | √ | string | reports.status对应的中文解释 |
| reports.time | √ | string | 状态报告的时间 |
| reports.pieces | √ | int | 如果遇到长文本短信,会把一条短信拆成多次计费,pieces代表计费几次 |
| reports.time | √ | string | 状态报告的时间 |
| reports.ext | √ | string | 扩展号 |
| reports.ref | string | reference参数(如果有则返回) | |
| reports.account | √ | string | 客户账号,一般是 6 位字母数字混合构成 |