接口文档>状态报告推送

状态报告推送说明

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

 

1、推送参数

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

2、数据示例

字符串(&)格式:
op=dr&rp=0&da=002&sd=20210608171000&id=139243071665625885&dd=20210608171001&di=1&sa=19788888888&su=DELIVRD
JSON格式:
[{"op":"dr","rp":"0","da":"002","sd":"20210608171000","id":"139243071665625885","dd":"20210608171001","di":"1","sa":"19788888888","su":"DELIVRD"}]

3、注意事项

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