查询账户余额

用于查询账户当前余额，分为现金余额和代金券余额，调用时需要计算数字签名。

URL

https://sms.wilddog.com/api/v1/{:SMSAppID}/getBalance

返回数据格式

JSON

HTTP 请求方式

GET

参数说明

参数	类型	必选	说明
signature	string	是	数字签名，合法性验证，其中参与数字签名计算的参数包括`timestamp`
timestamp	string	是	UNIX 时间戳，精度为毫秒

注意：

生成数字签名时不要使用 urlencode，在调用 API 时，才需要对参数做 urlencode

返回账户余额单位为厘，1 元 = 1000 厘。

返回说明

正常返回如下：

"Content-Type": "application/json; charset=utf-8" 
{
	"status":"ok", 
	"data":"{
			"balance" : 10000000 // 现金余额   
			"voucherBalance" : 10000000// 代金券余额     
	}
}

异常返回如下：

{
  "errcode": 7xxxx,
  "message": "xxxxxx"
}

其中 errcode 对应信息在此处查询短信错误码。

示例代码

curl -X GET https://sms.wilddog.com/api/v1/{SMSAppID}/getBalance -d "signature=$signature&timestamp=$timestamp"

上次更新：2018-06-21