查短信发送记录

HTTP头信息:

  1. Accept:application/json;charset=utf-8;
  2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

请求

URL:https://sms.yunpian.com/v2/sms/get_record.json

注意:海外服务器地址 us.yunpian.com

访问方式:POST

请求参数

参数名类型是否必须描述示例
apikeystring用户唯一标识9b11127a9701975c734b8aee81ee3526
mobilestring需要查询的手机号15205201314
start_timestring短信发送开始时间2013-08-11 00:00:00
end_timestring短信发送结束时间2013-08-12 00:00:00
page_numinteger页码,默认值为11
page_sizeinteger每页个数,最大100个,默认值为2020
typestring选择短信类型,默认为空,只能获取国内短信记录;all,国内与国际记录均可获取;global,只能获取国际短信记录。all

响应

名称类型描述
sidlong(64位)短信id,64位整型, 对应Java和C#的long,不可用int解析
mobilestring接收手机号
send_timestring发送时间
textstring短信的内容
send_statusstring发送状态
report_statusstring报告状态
feeinteger发送成功短信的计费条数(计费条数:70个字一条,超出70个字时按每67字一条计费)
user_receive_timestring用户接收时间
error_msgstring运营商返回的代码,如:"DB:0103"
uidstring用户自定义的id

Json响应示例:

调用成功的返回值示例:

  1. [
  2. {
  3. "sid": "1234567890",
  4. "mobile": "13800000000",
  5. "send_time": "2015-11-02 16:34:56",
  6. "text": "【云片网】你的验证码是1234",
  7. "send_status": "SUCCESS",
  8. "report_status": "FAIL",
  9. "fee": 1,
  10. "user_receive_time": null,
  11. "error_msg": "1:1",
  12. "uid": null
  13. },
  14. {
  15. "sid": "1234567891",
  16. "mobile": "13800000000",
  17. "send_time": "2015-11-02 15:34:42",
  18. "text": "【云片网】你的验证码是4321",
  19. "send_status": "SUCCESS",
  20. "report_status": "FAIL",
  21. "fee": 1,
  22. "user_receive_time": null,
  23. "error_msg": "1:1",
  24. "uid": null
  25. }
  26. ]