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
현재 Management token에 연결된 조직입니다.
balancenumber
현재 조직 잔액입니다. USD JSON number이며 표시용입니다.
balance_decimalstring
현재 조직 잔액입니다. USD decimal string이며 정확한 대조용입니다.
total_rechargenumber
성공한 조직 충전 총액입니다. USD JSON number이며 표시용입니다.
total_recharge_decimalstring
성공한 조직 충전 총액입니다. USD decimal string이며 정확한 대조용입니다.
total_usednumber
조직 누적 사용 지출입니다. USD JSON number이며 표시용입니다.
total_used_decimalstring
조직 누적 사용 지출입니다. USD decimal string이며 정확한 대조용입니다.

인증

ManagementTokenAuth
AuthorizationBearer <token>

관리 토큰 인증입니다. Dashboard > API > Management Tokens에서 관리 토큰을 생성하거나 관리하십시오.

위치: header

응답

application/json

application/json

application/json

application/json