接口功能:查询号码的短信记录

请求方向:第三方应用平台 → 小号平台(服务端)。

请求方法:POST

请求 URI:{BaseUrl}/virtual/querysms

请求消息体:

参数名 类型 最大长度 是否可选 解 释
number String 11 可选 虚拟小号
aparty String 15 可选 A 号码
bparty String 15 可选 B 号码
timestart String 10 可选 查询的开始时间
timeend String 10 可选 查询的结束时间
page String 10 可选 分页,每页 100 条数据
time String 10 必选 Unix 时间戳,用来限制接口连接的有效期,有效期为 10 分钟
appkey String 32 必选 应用的 appkey
sign String 32 必选 生成的加密校验码

响应消息:

{
    "success": true,
    "code": 200,
    "msg": "",
    "data": {
        "count": 1,
        "list": [
            {
                "number": "8617100000000",
                "calling": "8617100000001",
                "called": "8617100000002",
                "smscontent": "xxxx",
                "smsidentifier": "...",
                "subscriptionid": "...",
                "timestamp": "1542343546"
            }
        ],
        "page": 1
    }
}

// number: 虚拟小号
// calling: 主叫号码
// called: 被叫号码
// smscontent: 短信内容
// smsidentifier: 短信唯一id
// subscriptionid: 绑定关系id
// timestamp: 短信发送时间

错误码说明:

错误码 描述
E302201 虚拟小号格式错误,只能是 86+11 位手机号码
E302202 A 号码格式错误
E302203 B 号码格式错误
E302204 开始时间请小于现在
E302205 开始时间请大于 2017-01-01
E302206 结束时间请小于现在
E302207 结束时间请大于开始时间
文档更新时间: 2020-12-30 09:18   作者:admin