文档中心 > 状态报告用户自取
状态报告用户自取

最近更新时间: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": "无数据",

}