查询账户余额
相关内容:
该接口用于查询某个小游戏中可供提现的红包金额剩余。
该接口每10秒最多调用1次。
接口地址
请求方式 | 地址 |
GET | https://api.kuaiyugo.com/api/payment/v1/programs/:programId/transfers/withdraw?timestamp=1548315226&nonce_str=abc123&signature=20ec96c1f22979398ac06a0f13e49207 |
参数说明
以下各字段均为必填:
字段 | 类型 | 说明 | 位置 |
programId | string | 星汉下发的小程序programId | params |
timestamp | number | 秒级时间戳,整数 | input |
nonce_str | string | 最长32位的随机字符串,用于签名的计算 | input |
signature | string | 签名,具体算法在下文详述 | input |
字段 | 类型 | 说明 | 位置 |
miniprogram | string | 小程序appid | header |
accesstoken | string | 星汉平台的accessToken,不建议使用 | header |
jwt | string | 星汉平台jwt校验 ,建议使用 | header |
其中, accesstoken
与 jwt
需选择其中任一使用。
返回格式
返回值说明
字段 | 类型 | 说明 |
err | number | 错误码,非0即有错误 |
msg | string | 提示信息 |
data | object | 返回数据 |
data.amount | number | 红包账户余额,单位为分 |
异常说明
错误码 | 状态码 | 提示文本 | 说明 |
1331 | 200 | 应用未授权 | 该应用没有提现资格,需联系商务对接人开启权限 |
1337 | 200 | ip不在授信范围内 | 需联系商务对接人添加ip白名单 |
1339 | 200 | 签名错误 | |
1345 | 200 | 无法找到应用密钥 | 请联系商务对接组配置 |
1347 | 200 | 查询操作过快 | 每10秒最多调用1次 |
签名
Last Updated: 3/21/2019, 4:31:09 PM