查询余额
错误排查
调用过程中遇到错误?请参阅 API 错误码参考 获取完整的错误类型说明与排查方案。
http
GET https://openqiao.com/api/v1/management/payg/balance获取当前账号的 Pay As You Go 余额信息,包括总余额及各来源的 credit 明细。
鉴权
Authorization Header *
http
Authorization: Bearer <OPENQIAO_MANAGEMENT_API_KEY>- 参数名:
Authorization - 格式:
Bearer <API_KEY> - 说明:Management API Key,在 开桥控制台 创建
仅支持 Management API Key
本接口仅接受 Management API Key 鉴权,不支持普通 API Key。
限流
每个接口独立计数,每分钟最大请求数由平台统一配置。超出限制时返回 422 错误。
返回值
data.currency string
货币单位,固定为 "usd"。
data.total_credits number
账号当前 PAYG 总余额(美元)。
data.top_up_credits number
通过充值获得的余额(美元)。
data.bonus_credits number
通过奖励、赠送等方式获得的余额(美元)。
余额来源
total_credits = top_up_credits + bonus_credits(可能因浮点精度存在极小误差)。
cURL
curl https://openqiao.com/api/v1/management/payg/balance \
-H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY"json
{
"success": true,
"data": {
"currency": "usd",
"total_credits": 482.74,
"top_up_credits": 35.0,
"bonus_credits": 447.74
}
}