流量 HTTP 回调接口对接指南


概述

  • 回调地址由客户提供地址,地址被注册到秒信云平台绑定到对应的短信发送账号。
  • 当流量包购买成功或者失败的时候,秒信云平台会主动通知客户,秒信云会主动发起http post给客户设定的回调地址,以固定形式发送给客户。
  • 整体流程图如下:

流量购买状态回调接口

为保证及时有效的将流量包支付状态回传给客户,需要客户提供一个接收购买消息回传的HTTP接口地址,在客户接入秒信平台的时候,将此接口地址注册到秒信平台当中,也可以将接口地址随时提交给客户经理进行修改。也可以登录秒信云控制台自行设定。

  • 提交地址::客户设定
  • 提交方法:POST
  • 提交格式:application/x-www-form-urlencoded
Post参数

秒信平台把短信状态以“reports”的参数名传送给客户预设的HTTP回调地址,数据会以json的方式组织,格式如下: 示例如下:

{ 
    "total":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",
            "ref":""                   
        },
        {
            "order_id":"1839347820929302093",       
            "mobile":"18600000000",              
            "status":0,      
            "msg":"信息提示",              
            "received_time":"2016-12-22 23:11:40",
            "done_time":"2016-12-22 23:11:40",
            "ref":""
        }
    ]
}
Post JSON参数含义
变量名 必反 类型 含义
total int 代表本次返回多少个信息状态
reports array 汇报内容是一个数组,会对每一个订单的下发请求做单独的详情汇报
reports.order_id string 提交成功后的订单id
reports.mobile string 目标充值用户手机号码

账号开启加密后手机号则为加密后的密文。
reports.status int 状态报告:
1代表最终发送成功
其他代表失败
reports.msg string reports.status对应的中文解释
reports.receive_time string 提交充值申请的时间
reports.done_time string 完成充值的时间
reports.ref string reference参数(如果有则返回)
要求客户系统应答内容

当客户收到异步推送后,要求接口在内容正文中返回包含success字样,如果没有此字样,秒信平台认为本次装填推送没有完成,秒信平台会在1分钟、3分钟、15分钟、30分钟、60分钟、180分钟后分别尝试再次推送,如果尝试后还无法成功推送,则不再推送。

results matching ""

    No results matching ""