跳到正文

查询余额 ​

Troubleshooting

Encountering errors? See the API Error Codes Reference for a complete list of error types and troubleshooting steps.

http
GET https://openqiao.com/api/v1/management/payg/balance

Returns the Pay As You Go credit balance for the current account, including the total balance and a breakdown by credit source.

Authentication ​

Authorization Header * ​

http
Authorization: Bearer <OPENQIAO_MANAGEMENT_API_KEY>
  • Name: Authorization
  • Format: Bearer <API_KEY>
  • Description: A Management API Key created in the 开桥 Console

Management API Key required

This endpoint only accepts Management API Keys. Standard API Keys are not supported.

Rate Limiting ​

Each endpoint has its own independent rate limit counter. The maximum number of requests per minute is configured at the platform level. Exceeding the limit returns a 422 error.

Returns ​

data.currency string ​

Currency unit. Always "usd".

data.total_credits number ​

The account's current total PAYG credit balance (USD).

data.top_up_credits number ​

Credits obtained through direct top-ups (USD).

data.bonus_credits number ​

Credits obtained through bonuses, gifts, or promotions (USD).

Balance breakdown

total_credits = top_up_credits + bonus_credits (minor floating-point differences may apply).

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
  }
}
查询余额
cURL
curl https://openqiao.com/api/v1/management/payg/balance \
  -H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY"
Response
{
  "success": true,
  "data": {
    "currency": "usd",
    "total_credits": 482.74,
    "top_up_credits": 35.0,
    "bonus_credits": 447.74
  }
}