产品

物联网卡服务

短信 HTTP 上行回调接口对接指南

概述

短信上行回调地址由客户方提供，地址被注册到秒信云平台对应的短信发送账号；
用户回复（MO或上行）短信的时候，运营商会把对应的内容通知给秒信云平台；
秒信会分拣属于哪个客户的上行内容，会异步的通知到对应的客户；
秒信云会主动发起http post给客户设定的上行回调地址，以固定形式发送给客户；

用户上行内容回调接口

为保证将用户上行的信息时时传递给客户，需要客户提供一个接收短信上行信息的HTTP接口地址，在客户接入秒信平台的时候，将此接口地址注册到秒信平台当中，也可以将接口地址随时提交给客户经理进行修改。

提交地址：：客户设定
提交方法：POST
提交格式：application/x-www-form-urlencoded

Post参数

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

{ 
    "total":2, 
    "reports":
    [
        {
                "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":"2210250000000000002"
        }
    ]
}

Post JSON参数含义

变量名	必返	类型	含义
total	√	int	代表本次post多少个上行信息
reports	√	array	汇报内容是一个数组，会对用户的每一条上行信息做单独的详情
reports.user_mobile	√	string	用户上行的手机号码账号开启加密后手机号则为加密后的密文。
reports.user_content	√	string	用户上行的内容
reports.channel_num	√	string	上行的通道号码
reports.mo_time	√	string	上行时间
reports.signature	x	string	子码对应的签名短信下行，不同签名分配到不同子码上，上行时同步推送子码对应的签名。按需开启，需要时请联系客服开启
reports.account	√	string	客户账号，一般是 6 位字母数字混合构成
reports.order_id	√	string	上行短信对应的订单 id

要求客户系统应答内容

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

results matching ""

No results matching ""