短信 HTTP 发送订单状态检查


接口概述

通过接口,可以查询到一个或者多个订单的发送状态信息。

短信发送状态查询接口

  • 提交地址::http(s)://www.51miaoxin.com/sms/check
  • 提交方法:POST
  • 提交格式:application/x-www-form-urlencoded
字段 必填 类型 描述
account string 参考:短信HTTP 接口对接总览
token string 参考:短信HTTP 接口对接总览
ts string 参考:短信HTTP 接口对接总览
orderIds string 可以一次查询一个订单或者多个订单,多个订单号用半角字符“,”分开
接口应答JSON格式如下
{
      "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"                            
                  }
            ]
}
接口应答JSON数据含义
变量名 必返 类型 含义
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 位字母数字混合构成

results matching ""

    No results matching ""