余额查询 查询用户余额及接口价格(列表)
- 请求所有接口均会返回 cost(扣费) 和 balance(余额)字段
- 接口:http://api.3023data.com/user/balance
- 方式:GET
- 价格:0.001元/次 价格优惠,最低至2.5折
- 2.5折时:0.00025元/次
请求参数
参数 | 位置 | 必填 | 值 |
key | header | 是 | key |
key in request header or url
返回示例
{ "code": 0, "data": { "id": 9, //用户ID "balance": 5310.25, //余额 "services": [ //接口价格(列表) { "id": "coverage", "name": "苹果保修查询", "path": "/apple/coverage", "price": "0.2-0.8" }, ... "lastused": "2020-11-08 13:53:32" //上次使用时间 }, "source": "balance", "cost": 0.001, //扣费 "balance": 5310.25 //余额(请求所有接口均会返回该字段) } 已下线或停止维护的接口不在接口列表显示
接口错误码所有接口错误码一致
400 | Bad Request | 请求参数错误 |
404 | Not Found | 无效或不存在 |
502 | Bad Gateway | 不支持或查询失败 |
503 | Service Unavailable | 繁忙或者临时维护,请稍后重试 |
410 | Gone | 接口已失效/下线 |
code = 错误码 (int),message = 错误信息 (string)
查询成功:code===0
每次请求均会返回 cost(扣费) 和 balance(余额),方便随时记录和监控
错误(400)和无效(404)扣费 0.02 元,其他错误不扣费
用户错误码
401 | Unauthorized | 密钥无效 |
402 | Payment Required | 余额不足 |
403 | Forbidden | 无权限(IP白名单限制) |
接口具体错误信息见 message
如果前端需要返回错误信息,请直接返回 message 的内容