6.1 用户余额查询接口
优质
小牛编辑
128浏览
2023-12-01
接口说明
该接口由开发者开放给变现猫,变现猫进行调用。
这个请求参数为appUid、AppKey、时间戳等信息,并对请求参数进行MD5签名。开发者收到该请求后,需要对签名进行验证,验证通过后请返回余额信息给变现猫。
接口地址:在开发者后台接口配置模块配置(URL以http:\/\/开头)
示例:http://www.xxx.com/api/getAppBalanceApi.json
请求方式:GET
输入参数:
参数 | 是否必须 | 参数类型 | 限制长度 | 参数说明 |
---|---|---|---|---|
appUid | yes | string | 255 | app用户id |
appKey | yes | string | 255 | 接口appKey,应用的唯一标识 |
timestamp | yes | string | 20 | 服务器当前时间,1970-01-01开始的时间戳,毫秒为单位。 |
sign | yes | string | 255 | MD5签名,将URL中每个参数值和appSecret(appSecret在开发者后台接口配置处可查看密钥)按照参数名称升序,拼接然后md5转码 详见MD5签名规则https://www.xnip.cn/doc/RV0OpbQJLtmd5.html) |
响应参数:
参数 | 是否必须 | 参数类型 | 限制长度 | 参数说明 |
---|---|---|---|---|
status | yes | string | 255 | 查询状态,回复ok或者fail |
errorMessage | no | string | 255 | 出错原因(请用utf-8进行URL编码,防止中文乱码,javaURL编解码详见http://blog.csdn.net/u011627980/article/details/50911249) |
balance | yes | number数字 | 20 | app用户余额余额 |
请按JSON格式返回结果。
响应示例:
成功:
{
'status': 'ok',
'errorMessage': '',
'balance': '1000'
}
失败:
{
'status': 'fail',
'errorMessage': '失败原因(通知变现猫)'
}
请求超时处理方式:
变现猫向开发者发起扣余额查询请求时,变现猫设置超时时间为30秒,由于开发者服务器响应过慢,或者网络异常等原因,可能会出现超时情况。如果请求超时,变现猫将在该笔交易中取消余额支付方式。