获取短信状态报告
提交方式：
支持https
只支持POST,该接口数据输入输出均采用json格式封装的字符串，编码（对整个请求的字符串编码）统一为UTF-8，采用post方式提交请求。
功能:
获取状态报告；建议有数据时无需休眠，当请求无数据返回时，客户端休眠30秒再进行请求。每次最多取200条状态报告。
请求参数:
参数值说明：以下json内容为提交请求数据格式
{
"account":"dh****",
"password":"0243614f784a8cfa94a94b85cbee7540"
}
| 参数名 | 说明 |
|---|---|
| account | 用户账号 |
| password | 密码，需采用MD5加密(32位小写) |
返回示例:
{
"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 | 接口调用结果，说明请参照：提交响应错误码；当result为0时reports字段将出现0到1次，否则reports字段不出现 |
| 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 | 长短信拆分第几条标示 |
Postman 请求示例截图
文档更新时间: 2025-10-31 13:14 作者：夏亮
