接口文档中心
让您的接入更简单

状态报告推送说明

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

 

1、推送参数

名称 类型 是否必须 示例值 描述
op String dr dr值表示推送类型为状态报告
rp Int 0 错误码,0 表示成功, 其他见错误码表
da Int 002 扩展子号,运营商返回一般不需要处理该字段
sa String 1309999XXXX 手机号码
id String 18888888666666XXX 短信消息编号。短信发送接口有返回,可以根据该编码做状态匹配
su String DELIVRD 状态说明,接受成功时为:DELIVRD或0
sd String 20261021091013 短信提交时间(格式:yyyyMMddHHmmss)
dd String 20261021091013 短信接受时间(格式:yyyyMMddHHmmss)
di Int 1 群发时号码所在的位置

2、数据示例

字符串(&)格式:
op=dr&rp=0&da=002&sd=20261021091013&id=13555566661998&dd=20261021091013&di=1&sa=1309999XXXX&su=DELIVRD
JSON格式:
[{"op":"dr","rp":"0","da":"002","sd":"20261021091013","id":"135555666619980001","dd":"20261021091013","di":"1","sa":"1309999XXXX","su":"DELIVRD"}]


3、注意事项

√ 状态报告
    1)请注意接受状态报告的数据格式,如有问题请及时联系技术支持或相关客服;
    2)请注意服务器在内网环境没有端口映射是无法接受推送数据的。