# 回执消息推送

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

# 协议说明

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

# 请求说明

请求为 JSON Array 格式,单次请求可能会包含多个短信回执状态报告内容。

请求示例

HTTP示例:

[
    {
          "smsId": "6b4a5938-c475-4b97-b208-89a567bd3e03",
          "code": "OK",
          "msg": "OK",
          "datetime": "2020-01-01 12:00:00 +0000",
          "status": "submit",
          "bizId": "abcdefg",
    }, 
    {
          "smsId": "as8xhzz7-coiu-0988-ckni-zxclkjqweoik",
          "code": "OK",
          "msg": "OK",
          "datetime": "2020-01-02 13:00:00 +0000",
          "status": "submit",
          "bizId": "i9mxbv",
    },
]

# 参数说明

参数名称 必选 类型 描述
smsId String 短信的唯一标识。
datetime String 菊风电信云短信服务收到线路供应商回执状态的时间。
code String 来自线路供应商回执状态结果。"OK": 线路供应商已成功收到短信请求或者成功发出短信。"Failed": 线路供应商未收到短信请求或者未成功发出短信。
msg String 来自线路供应商短信发送错误码描述。
status String submit:线路供应商收到发送短信请求。delivery:线路供应商发出短信 。
bizId String 预留给调用方使用的业务ID,调用发送短信接口时填入。

# 响应说明

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

# 重推说明

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

最后更新时间: 2022/4/22 09:23:40