回执消息推送

通过 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	菊风电信云短信收到运营商回执状态的时间。
code	是	String	来自运营商回执状态结果。"OK": 运营商已成功发出短信。"Failed": 运营商未成功发出短信。
msg	是	String	来自运营商短信发送状态码描述。
status	是	String	delivery：运营商发出短信 。
bizId	否	String	预留给调用方使用的业务 ID，调用发送短信接口时填入。

响应说明

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

重推说明

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