注册送短信

接口文档

API查询余额接口

1.1 调用地址

地址http://address:port/sms/api/getBalance

请求方法:POST

1.2 请求包头定义

Accept: application/json

Content-Type: application/json;charset=utf-8

1.3 请求参数

参数名

类型

必填

说明

userName

String

帐号用户名

timestamp

Long

当前时间戳,精确到毫秒。

例如2020年8月1日12:00:00 时间戳为:1596254400000

sign

String

由以下参数值组合成字符串并计算MD5值,参考详细规则

计算:MD5(userName + timestamp + MD5(password))

1.1 响应结果

参数名

类型

说明

code

Integer

处理结果,0为成功,其他失败,详细参考响应状态码

message

String

处理结果描述

balance

Long

当code=0时,系统返回帐号短信余额

 

1.2 请求示例

状态获取请求:

POST http://address:port/sms/api/getBalance

Accept: application/json

Content-Type: application/json;charset=utf-8

 

{

"userName""test",

"timestamp"1596254400000,

"sign""e315cf297826abdeb2092cc57f29f0bf"

}

响应结果:

{

"code"0,

"message""处理成功",

"balance"967793

}