接口功能:查询号码的短信记录
请求方向:第三方应用平台 → 小号平台(服务端)。
请求方法: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