管理
取得組織餘額
返回目前管理令牌所屬組織的餘額彙總。
GEThttps://api.tokenlab.sh/v1/management/balance
概覽
這個端點返回目前管理令牌所屬組織的餘額彙總。它使用與計費和結算相同的組織餘額事實源。
注意事項
-
金額欄位僅支援 USD。
-
金額欄位以 USD 返回。展示可使用
balance、total_recharge、total_used;精確計費對帳請使用balance_decimal、total_recharge_decimal、total_used_decimal。
請求
curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"請求 / 回應
本頁提供 OpenAPI 結構說明及可複製的請求範例。請在終端機或用戶端使用 Management Token 傳送管理請求;本頁不提供直接傳送功能。
回應
{
"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