接口文档>上行回复推送

上行回复推送说明

    1)数据推送是指平台将短信状态报告数据通过HTTP POST协议发送到客户的服务器上,客户需预备HTTP服务器;
    2)异步通知类型的接口,有状态报告下发,平台立即主动推送到客户预备的URL上;
    3)控制台>接口短信>设置,填写接受地址。例:http://report.abc.com/receive/;
    4)如果接受地址错误或接收服务器出现故障,推送数据可能会丢失;
    5)推送数据采用“&"字符串拼接和JSON两种数据格式,默认前一种;
    6)如服务器在内网环境无法接受数据,平台将提供轮询方式主动获取上行回复的接口;

 

1、推送参数

名称 类型 是否必须 示例值 描述
op String mo mo值表示推送类型为回复
dc Int 8 回复编码方式, 8:UCS2,15:GB2312
da Int 002 扩展子号,运营商返回一般不需要处理该字段
sa String 19788888888 手机号码
sd String 20250123080808 回复提交时间(格式:yyyyMMddHHmmss)
sm String 6d4b8bd556de590d 回复内容(16进制字符串),编码格式8:UCS2,15:GB2312

2、数据示例

字符串(&)格式:
op=mo&id=166002383841610167&dc=8&sa=19788888888&da=002&sd=20210806114430&sm=6d4b8bd556de590d
JSON格式:
[{"op":"mo","id":"166002383841610167","dc":"8","sa":"19788888888","da":"002","sd":"20210806114430","sm":" 测试回复"}]

3、注意事项

√ 上行回复
    1)请注意接受上行回复的数据格式,如有问题请联系平台技术支持或客服;
    2)请注意服务器在内网环境没有端口映射是无法接受推送数据的,如有问题请联系平台技术支持或客服;
    3)请注意状态报告和上行回复是推送到一个地址的,op字段区分是状态报告还是回复;