短信状态报告及上行主动拉取HTTP接口


接口概述

  • 客户主动拉取,每次返回最多100条
  • 建议客户3秒拉取一次,如果返回100条可以不停立刻继续
  • 数据保留一星期,一个星期不拉取,自动删除

  • 注:未开通/sms/moPull接口时,/sms/pull接口直接获取短信状态和上行内容。如需将短信状态和上行内容分开获取,可按需使用/sms/moPull接口。/sms/moPull接口使用需联系客服对账号进行调整,开启后,/sms/pull接口只返回短信状态数据,/sms/moPull接口返回上行内容数据。

拉取短信发送

  • 提交地址::http(s)://www.51miaoxin.com/sms/pull
  • 提交方法:POST
  • 提交格式:application/x-www-form-urlencoded
字段 必填 类型 描述
account string 参考:短信HTTP 接口对接总览
token string 参考:短信HTTP 接口对接总览
ts string 参考:短信HTTP 接口对接总览
接口应答JSON格式如下
{ 
    "total": 4, 
    "total_mt_report": 2, 
    "total_mo_report": 2, 
    "reports": [
        {
            "order_id":"1839347820929302091",       
            "mobile":"18600000001",              
            "status":0, 
            "msg":"信息提示",              
            "received_time":"2016-12-22 23:11:40",
            "done_time":"2016-12-22 23:11:40",
            "pieces":1,
            "ext":"123",
            "ref":"",
            "account":"10000a"                   
        },
        {
            "order_id":"1839347820929302093",       
            "mobile":"18600000000",              
            "status":0,      
            "msg":"信息提示",              
            "received_time":"2016-12-22 23:11:40",
            "done_time":"2016-12-22 23:11:40",
            "pieces":1,
            "ext":"123",
            "ref":"",
            "account":"10000a" 
        }
    ],
    "mos": [
        {
            "user_mobile":"18600000000",       
            "user_content":"上行内容",              
            "channel_num":"1234",              
            "mo_time":"2016-12-22 23:11:40",
            "account":"10000a",
            "order_id":"2210250000000000001"
        },
        {
            "user_mobile":"18600000000",       
            "user_content":"上行内容",              
            "channel_num":"1234",              
            "mo_time":"2016-12-22 23:11:40",
            "account":"10000a",
            "order_id":"2210250000000000001"
        }
    ]
}
接口应答JSON数据含义

基本信息字段含义如下

变量名 必返 类型 含义
total int 代表本次返回多少个信息状态,上下行状态总和
total_mt_report int 代表本次返回多少个下行MT信息状态
total_mo_report int 代表本次返回多少个上行MO信息状态
reports array 汇报内容是一个数组,会对每一个订单的下发请求做单独的详情汇报
mos array 汇报内容是一个数组,记录每一条上行状态的详细信息

reports 数组里面是下行消息,具体含义如下

变量名 必返 类型 含义
reports.order_id string 短信提交成功后的订单id
reports.mobile string 发送的目标客户手机号码

账号开启加密后手机号则为加密后的密文。
reports.status int 状态报告:

负数代表平台驳回,详见错误代码对应表
0代表平台收到消息,还在处理
1代表最终发送成功
2代表测试状态模拟成功
3代表正在发送中(未回状态)
大于3代表运营商反馈发送失败
reports.msg string reports.status对应的中文解释
reports.received_time string 秒信收到客户提交发送短信的时间
reports.done_time string 秒信收到运营商反馈状态时间(正常情况下等同于用户接收到短信时间,如果运营商推送服务出现宕机,此时间会滞后)
reports.pieces int 计费条数
reports.ext string 扩展号
reports.ref string reference参数(如果有则返回)
reports.account string 客户账号,一般是 6 位字母数字混合构成
reports.src_number x string 回传实际码号

mos 数组里面是上行消息,具体含义如下

变量名 必返 类型 含义
mos.user_mobile string 用户上行的手机号码

账号开启加密后手机号则为加密后的密文。
mos.user_content string 用户上行的内容
mos.channel_num string 上行的通道号码
mos.mo_time string 上行时间
mos.signature x string 子码对应的签名
短信下行,不同签名分配到不同子码上,上行时同步推送子码对应的签名。按需开启,需要时请联系客服开启
mos.account string 客户账号,一般是 6 位字母数字混合构成
mos.order_id string 上行短信对应的订单 id

results matching ""

    No results matching ""