查短信发送记录
HTTP 头信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
请求
URL:`https://sms.yunpian.com/v2/sms/get_record.json`
注意:海外服务器地址 us.yunpian.com
访问方式:POST
请求参数
参数名 | 类型 | 是否必须 | 描述 | 示例 |
apikey | string | 是 | 用户唯一标识,在"账号设置"-"子帐号管理"中查看 | 9b11127a9701975c734b8aee81ee3526 |
mobile | string | 否 | 需要查询的手机号 | 15205201314 |
start_time | string | 是 | 短信发送开始时间 | 2013-08-11 00:00:00 |
end_time | string | 是 | 短信发送结束时间 | 2013-08-12 00:00:00 |
page_num | integer | 否 | 页码,默认值为 1 | 1 |
page_size | integer | 否 | 每页个数,最大 100 个,默认值为 20 | 20 |
type | string | 否 | 选择短信类型,默认为空,只能获取国内短信记录;all,国内与国际记录均可获取;global,只能获取国际短信记录。 | all |
响应
名称 | 类型 | 描述 |
sid | long(64 位) | 短信 id,64 位整型, 对应 Java 和 C#的 long,不可用 int 解析 |
mobile | string | 接收手机号 |
send_time | string | 发送时间 |
text | string | 短信的内容 |
send_status | string | 发送状态 |
report_status | string | 报告状态: SUCCESS、FAIL、UNKNOWN |
fee | integer | 发送成功短信的计费条数(计费条数:70 个字一条,超出 70 个字时按每 67 字一条计费) |
user_receive_time | string | 用户接收时间 |
error_msg | string | 运营商返回的代码,如:"DB:0103" |
uid | string | 用户自定义的 id |
Json 响应示例:
调用成功的返回值示例:
[
{
"sid": "1234567890",
"mobile": "13800000000",
"send_time": "2015-11-02 16:34:56",
"text": "【云片网】你的验证码是1234",
"send_status": "SUCCESS",
"report_status": "FAIL",
"fee": 1,
"user_receive_time": null,
"error_msg": "1:1",
"uid": null
},
{
"sid": "1234567891",
"mobile": "13800000000",
"send_time": "2015-11-02 15:34:42",
"text": "【云片网】你的验证码是4321",
"send_status": "SUCCESS",
"report_status": "FAIL",
"fee": 1,
"user_receive_time": null,
"error_msg": "1:1",
"uid": null
}
]