余额查询 查询用户余额及接口价格(列表)

  • 请求所有接口均会返回 cost(扣费) 和 balance(余额)字段

请求参数

参数位置必填
keyheaderkey

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  //余额(请求所有接口均会返回该字段)
}

已下线或停止维护的接口不在接口列表显示

接口错误码所有接口错误码一致

400Bad Request请求参数错误
404Not Found无效或不存在
502Bad Gateway不支持或查询失败
503Service Unavailable繁忙或者临时维护,请稍后重试
410Gone接口已失效/下线

code = 错误码 (int),message = 错误信息 (string)
查询成功:code===0
每次请求均会返回 cost(扣费) 和 balance(余额),方便随时记录和监控
错误(400)和无效(404)扣费 0.02 元,其他错误不扣费

用户错误码

401Unauthorized密钥无效
402Payment Required余额不足
403Forbidden无权限(IP白名单限制)

接口具体错误信息见 message
如果前端需要返回错误信息,请直接返回 message 的内容