1)数据推送是指平台将短信状态报告数据通过HTTP POST协议发送到客户的服务器上,客户需预备HTTP服务器;
2)异步通知类型的接口,有状态报告下发,平台立即主动推送到客户预备的URL上;
3)控制台>接口短信>设置,填写接受地址。例:http://report.abc.com/receive/;
4)如果接受地址错误或接收服务器出现故障,推送数据可能会丢失;
5)推送数据采用“&"字符串拼接和JSON两种数据格式,默认前一种;
6)如服务器在内网环境无法接受数据,平台将提供轮询方式主动获取状态报告的接口;
名称 | 类型 | 是否必须 | 示例值 | 描述 |
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 | 群发时号码所在的位置 |
字符串(&)格式:
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"}]
√ 状态报告 :
1)请注意接受状态报告的数据格式,如有问题请联系平台技术支持或客服;
2)请注意服务器在内网环境没有端口映射是无法接受推送数据的,如有问题请联系平台技术支持或客服;