接口文档>状态报告推送

状态报告推送说明

    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）请注意服务器在内网环境没有端口映射是无法接受推送数据的，如有问题请联系平台技术支持或客服；