短信下发给用户后,短信服务可以通过回调业务 URL的方式,通知业务方短信下发的状态。
回调地址设置方式:登陆控制台,依次找到短信服务–系统设置–事件回调页面,点击事件回调页面中的设置按钮,在短信状态报告回调地址输入框中配置状态报告回调地址,点击保存按钮即可完成设置。
注意: 接入HTTP推送功能,请按照文档给的响应格式返回,否则会进行重推(1小时内,每10分钟重推一次未推送的状态报告)。
在返回响应结果之前,请确保接收状态报告服务,已经正常处理完状态报告。
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时的具体错误信息 |
文档内容是否对您有帮助?
评价建议不能为空
非常感谢您的反馈,我们会继续努力做到更好!