TokenLab

管理

取得組織餘額

返回目前管理令牌所屬組織的餘額彙總。

GEThttps://api.tokenlab.sh/v1/management/balance

概覽

這個端點返回目前管理令牌所屬組織的餘額彙總。它使用與計費和結算相同的組織餘額事實源。

注意事項

  • 金額欄位僅支援 USD。

  • 金額欄位以 USD 返回。展示可使用 balance、total_recharge、total_used;精確計費對帳請使用 balance_decimal、total_recharge_decimal、total_used_decimal。

範例

請求

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

請求 / 回應

本頁提供 OpenAPI 結構說明及可複製的請求範例。請在終端機或用戶端使用 Management Token 傳送管理請求;本頁不提供直接傳送功能。

回應範例

回應

200 OK
{
  "object": "organization_balance",
  "organization_id": "org_123",
  "balance": 42.5,
  "balance_decimal": "42.50",
  "total_recharge": 100,
  "total_recharge_decimal": "100",
  "total_used": 57.5,
  "total_used_decimal": "57.50"
}

重要欄位

objectstring
固定為 organization_balance。
organization_idstring
目前管理權杖所屬的組織。
balancenumber
目前組織餘額,USD JSON number,用於展示。
balance_decimalstring
目前組織餘額,USD 精確十進位字串,用於對帳。
total_rechargenumber
組織成功充值總額,USD JSON number,用於展示。
total_recharge_decimalstring
組織成功充值總額,USD 精確十進位字串,用於對帳。
total_usednumber
組織累計用量消費,USD JSON number,用於展示。
total_used_decimalstring
組織累計用量消費,USD 精確十進位字串,用於對帳。

授權

ManagementTokenAuth
AuthorizationBearer <token>

管理權杖驗證。請在 Dashboard > API > Management Tokens 建立或管理管理權杖。

位置: header

回應

application/json

application/json

application/json

application/json