推送状态报告
推送地址: 用户自定义,登陆3tong.net配置,位置如图:
获取方式:
编码统一为UTF-8,采用post方式提交请求。数据格式为JSON。收到Http请求后,使用getParameter(“report”)获取相应内容。如果用户有自定义属性,可以用getParameter方法获取
功能:
推送状态报告,1个数据包内,每次最多给200条状态报告。
和获取状态报告的接口之间只做一个
输入说明:
注意!该推送方式:提交为x-www-form-urlencoded,key为report其中value如下
推送数据格式:
{
"result":"0",
"desc":"成功",
"reports":[{
"msgid":"2c92825934837c4d0134837dcba00150",
"phone":"13534698345",
"status":"0",
"desc":"成功",
"wgcode":"DELIVRD",
"submitTime":"2015-03-17 16:32:16",
"sendTime":"2015-03-17 16:32:17",
"time":"2015-03-17 16:32:20",
"smsCount":1,
"smsIndex":1
},{
"msgid":"2c92825934837c4d0134837dcba02884d",
"phone":"13917599647",
"status":"0",
"desc":"成功",
"wgcode":"DELIVRD",
"submitTime":"2015-03-17 16:32:20",
"sendTime":"2015-03-17 16:32:20",
"time":"2015-03-17 16:32:21",
"smsCount":1,
"smsIndex":1
}]
}
参数名 | 说明 |
---|---|
result | 保留字段 |
desc | 保留字段 |
msgid | 短信编号 |
phone | 下行手机号码 |
status | 短信发送结果:0——成功;1——接口处理失败;2——运营商网关失败(判断发送到手机是否成功请务必使用该字段) |
desc | 状态报告描述 |
wgcode | 当status为1时,表示平台返回错误码,参考:状态报告错误码。当status为0或2时,表示运营商网关返回的原始值 |
time | 状态报告接收时间格式为yyyy-MM-dd HH:mm:ss |
submitTime | 客户提交时间格式为yyyy-MM-dd HH:mm:ss |
sendTime | 大汉三通发送时间格式为yyyy-MM-dd HH:mm:ss |
smsCount | 长短信拆分条数(接口处理失败(status=1)未拆分) |
smsIndex | 长短信拆分第几条标示 |
响应数据格式:
{
"status":"success"
}
返回参数说明:
参数名 | 说明 |
---|---|
status | 处理结果,成功时status的值返回success,其他值均认为推送失败。 |
Postman 推送示例截图
文档更新时间: 2022-11-18 17:29 作者:夏亮