HTTP批量推送状态报告

最近更新时间:2021-09-16 13:56:56

查看PDF

功能描述

短信下发给用户后,短信服务可以通过回调业务 URL的方式,通知业务方短信下发的状态。

回调地址设置方式:登陆控制台,依次找到短信服务–系统设置–事件回调页面,点击事件回调页面中的设置按钮,在短信状态报告回调地址输入框中配置状态报告回调地址,点击保存按钮即可完成设置。

注意: 接入HTTP推送功能,请按照文档给的响应格式返回,否则会进行重推(1小时内,每10分钟重推一次未推送的状态报告)。
在返回响应结果之前,请确保接收状态报告服务,已经正常处理完状态报告。

URL 示例

POST http://example.com/sms_report/callback

请求说明

请求体为JSON格式,单次请求可能会包含多个(最多500)状态报告结果。

POST /sms_report/callback HTTP/1.1
Host:example.com
Content-Type:application/json;charset=UTF-8
Content-Length:1246
[
        {
            "SendTime": "2020-06-05 14:47:02",
            "ReceiveTime": "2020-06-05 14:47:02",
            "Sid": "e8bd2ba7e2711591339622",
            "NationCode": "86",
            "ExtId": "asd123",
            "Status": "FAIL",
            "ErrCode": "SERVICE_ERROR",
            "ErrDesc": "系统错误",
            "NationEnCode": "CN",
            "SmsType": 2,
            "Mobile": "1xxxxxxxxxx",
            "SmsTotal": 1
        },
        {
            "SendTime": "2020-06-05 15:13:14",
            "ReceiveTime": "2020-06-05 15:13:14",
            "Sid": "1caef0622c101591341194",
            "NationCode": "86",
            "ExtId": "asd123",
            "Status": "FAIL",
            "ErrCode": "109",
            "ErrDesc": "拦截",
            "NationEnCode": "CN",
            "SmsType": 2,
            "Mobile": "1xxxxxxxxxx",
            "SmsTotal": 2
        }
]
参数 描述
Sid 发短信接口返回的发送标识Sid
NationCode 国家(或地区)码,数字
ErrCode 短信状态码
ErrDesc 短信状态码对应的失败原因说明
Status 短信接收状态,SUCCESS(成功)、FAIL(失败)
NationEnCode 国家(或地区)码,英文
SendTime 短信发送时间
Mobile 手机号
ReceiveTime 用户实际接收到短信的时间
ExtId 客户下发短信时的自定义流水号
SmsType 短信类型
SmsTotal 长短信拆分后的条数

响应参数

{
  "code" : 0,
  "msg" : "接收成功"
}
参数 类型 描述
code number 应答码,0表示成功,非0表示失败
msg string 描述信息,code 非0时的具体错误信息

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈