管理

获取工作区余额

获取管理令牌所属工作区的余额。

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

返回管理令牌所属工作区的余额、累计充值和累计用量费用。

本页提供 OpenAPI 结构说明和可复制的请求示例。请在终端或客户端使用 Management Token 发送管理请求;本页不提供直接发送功能。

注意事项

  • 金额字段仅支持 USD。

  • 金额以 USD 返回。需要精确计算时,请使用 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"

响应示例

响应

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
工作区 ID。
balancenumber
工作区余额,单位为 USD。
balance_decimalstring
工作区余额的精确十进制字符串。
total_rechargenumber
累计充值金额,单位为 USD。
total_recharge_decimalstring
累计充值金额的精确十进制字符串。
total_usednumber
累计用量费用,单位为 USD。
total_used_decimalstring
累计用量费用的精确十进制字符串。

授权

ManagementTokenAuth
AuthorizationBearer <token>

管理令牌身份验证。在 Dashboard > API > Management Tokens 中创建或管理管理令牌。

位置: header

响应

application/json

application/json

application/json

application/json