备案 控制台 登录 注册
文档中心 > 状态报告用户自取
状态报告用户自取

最近更新时间：2022-04-02

接口地址：http:// 103.131.171.81:9090/sms/balance/v1

请求方法：POST

接口描述：同一条数据只能获取一次，可通过参数指定数量，以实际获取数量为准。

请求参数

请求头里面需要设置传输格式：Content-type:application/json

参数名称

描述

是否必选

备注

appkey

应用key

是

参见“公共参数说明”

appcode

应用代码

是

参见“公共参数说明”

sign

签名验证MD5

是

appkey+appsecret+timestamp经过md5加密后的32位16进制小写字符串（拼接过程不包括+）

number

数量

是

数字，范围1到1000，不在该范围采用默认值200

timestamp

时间戳

是

时间戳(精确到毫秒)，当前时间5分钟内请求有效

 

请求示例

  {

    "appkey": "test",

    "appcode": "test",

    "number": "300",

    "sign": "de7cb2fb99756c06214fc78252d36484"

    "timestamp": "1520496753938",

  }


返回参数

参数名称

类型

描述

appkey

String

应用key

phone

String

手机号码

status

String

状态 0-成功 其他失败

desc

String

状态码描述

uid

String

短信唯一标识，对应提交响应返回的uid

report_time

String

状态报告时间

 

返回示例

请求成功响应信息说明：

[

  {

    "appkey": "huoguo",

    "desc": "DELIVRD",

    "phone": "15200000006",

    "report_time": "2018-03-15 01:01:46",

    "status": "0",

    "uid": "143536bbc41e4ef69c779cbb125f7317"

  },

  {

    "appkey": "huoguo",

    "desc": "UNDELIV",

    "phone": "15200000007",

    "report_time": "2018-03-15 01:01:49",

    "status": "2",

    "uid": "b671244d5c534cf7a10f3b99c31aa086"

  }

]

无数据格式：

{

  "code": "F0050",

  "desc": "无数据",

}