查询账户余额 编辑文档

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

URL

https://sms.wilddog.com/api/v1/{:appId}/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/{appId}/getBalance -d "signature=$signature&timestamp=$timestamp"
    野狗新手?
    立即注册,为你提供安全可靠的实时通信云服务。
    没找到需要的文档?
    你可以提交工单反馈 或 阅读常见问题
    期待收到你的反馈,帮助我们改进文档。
    参与调研