概述

企业短信记录查询，仅查询企业短信发送的数据（5.1.5 短信群发接囗v4.0），不包含号码发送。

调用形式

https://xtapi.uincall.com/api/call/querySmsReportV3.action

调用方式

POST

传入参数

序号 参数名称 是否必填 参数说明
1 appver 是 应用版本值：1
2 user 是 登录用户名
3 secret 是 计算sercert请阅读1 2 3(不能直接拿3获取到的token直接赋值给当前接口的secret进行调用）
4 timestamp 是 当前时间，服务端会验证时间有效性，如果与服务端时间差大于 10 分钟则请求无效。
5 account 是 企业号码
6 serviceSn 否 短信流水号，如果不填，则返回有运营商报告的短信记录，上限500条。

回应参数

序号 名称 是否必填 说明
1 errcode 是 0为成功，其它为失败。
2 errmsg 是 结果解释。
3 total 是 短信数量。
4 data 是 参考以下字段
5 uuid 是 短信详细表uuid
6 serviceSn 是 短信的流水号
7 sendStatus 是 发送状态：0：未发送，1：发送成功，2：发送失败，3：提交成功，4：提交失败
8 sendTime 是 发送时间
9 msg 是 短信内容
10 mobile 是 手机号码
11 description 否 发送结果描述

使用样例

调用：

https://xtapi.uincal.com/api/call/querySmsReportV3.action

post 数据：
    appver=1&user=400xxxxxxx_dev&secret=095b037180377a04e24dc6cd79d21b01&timestamp=20261010141300&account=400xxxxxxx&serviceSn=f72f247f-8c3b-41be-a5a4-f42d152c0802&corpId=33769358-xxxx-xxxx-xxxx-xxxxbb76f89b

响应：

{
    "errcode": 0,
    "total": 1,
    "data": [
        {
            "msg": "【北京思比邻通讯】欢迎使用优音通讯服务",
            "mobile": "186xxxx0001",
            "description": "-6541261025502376280:用户接收成功",
            "receipt": 1,
            "sendStatus": 1,
            "queried": 0,
            "serviceSn": "f72f247f-8c3b-41be-a5a4-f42d152c0802",
            "uuid": "3a94250b35164a708e40130f0213e1fd",
            "sendTime": "2026-10-10 14:12:24"
        }
    ],
    "errmsg": "查询成功"
}
文档更新时间: 2026-10-10 14:31   作者：admin