跳到主要内容

状态报告推送

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

协议说明

类别说明
URL用户配置的 HTTP 回调地址(当前需用户主动提供)
方式POST
协议HTTP + JSON
编码UTF-8

请求说明

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

请求示例

{
"MsgType": 2,
"Data": [
{
"SessionNo": "d0****f7-0fc3-****-****-9f73****6c6e",
"Phone": "185****9057",
"CostCount": 2,
"ReceiptTime": 1563867000,
"ReceiptResult": "发送成功", //通过该字段判断发送结果,枚举值见参数说明
"ReceiptCode": "Delivrd",
"ReceiptDesc": "用户接收成功",
"UserId": "you man c define the content by yrself"
},
{
"SessionNo": "d1****f7-0fc3-****-****-9f73****6c6e",
"Phone": "185****9057",
"CostCount": 2,
"ReceiptTime": 1563867000,
"ReceiptResult": "发送失败",
"ReceiptCode": "MSBLACK",
"ReceiptDesc": "手机在运营商防骚扰黑名单",
"UserId": "you man c define the content by yrself"
}
]
}

参数说明

Parameter nameTypeDescriptionCaseRequired
MsgTypeint推送消息类型,2 代表 回执状态报告2Y
DataArray批次列表Y
  • Data
Parameter nameTypeDescriptionCaseRequired
SessionNostring短信发送 的发送序列号xddd-xx-ss-ss-ssY
Phonestring手机号码18512345678Y
CostCountint短信拆分条数2Y
ReceiptTimeint状态报告时间1563867000Y
ReceiptResultstring回执状态结果,可根据该字段判断发送结果,枚举值:
> 发送成功 或 Success:代表短消息发送成功
> 发送失败 或 Fail:代表短消息发送失败
> 状态未知 或 Unknow:代表运营商未上报状态报告
发送成功Y
ReceiptCodestring状态报告编码DelivrdY
ReceiptDescstring状态报告说明用户接收成功Y
UserIdstring自定义的业务标识 ID,字符串( 长度不能超过 32 位),不支持 单引号、表情包符号等特殊字符ucloud-uhost-001N

响应说明

响应示例

{
code: 0,
message: "ok"
}

参数说明

codemessageDescription
0ok接收成功
非 0异常说明未接收成功

重推说明

首次推送失败后(非成功响应),将每隔 1 秒进行重推,累计重推 3 次仍未成功,将停止推送。