回执消息推送

通过HTTP批量推送的方式将短信回执状态报告推送至客户指定地址。

协议说明

字段	描述
URL	用户配置的HTTP回调地址（当前需用户主动提供）。
方式	POST
协议	HTTP + JSON
编码	UTF-8

请求说明

请求为 JSON 格式，单次请求一次只返回一个包含短信回执状态报告内容。

请求示例

HTTP示例：

[
    {
      "smsId": "ad376da606bc4f8fb64c7b0ede0b3a4f",
      "code": "OK",
      "msg": "DELIVRD",
      "datetime": "2023-04-19 15:13:39",
      "status": "delivery",
      "bizId": "bizId"
    }
    ...
]

参数说明

参数名称	必选	类型	描述
smsId	是	String	短信的唯一标识。
datetime	是	String	菊风电信云OTP验证码收到运营商回执状态的时间。
code	是	String	来自运营商回执状态结果。"OK": 运营商已成功发出短信。"Failed": 运营商未成功发出短信。
msg	是	String	来自运营商短信发送状态码描述。
status	是	String	delivery：运营商发出短信 。
bizId	否	String	预留给调用方使用的业务ID，调用发送短信接口时填入。

响应说明

HTTP状态码为200，代表回执消息接收成功。

重推说明

首次推送失败后（非成功响应），回执推送将最大重试10次，前3次失败每次重试间隔1分钟，第4、5次每次重试间隔10分钟，最后5次重试间隔1小时，10次后将放弃回执推送。