推送状态报告

推送地址: 用户自定义,登陆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   作者:夏亮