TokenLab

관리

워크스페이스 잔액 조회

현재 워크스페이스의 잔액, 충전 내역 및 사용 금액을 조회합니다.

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

개요

관리 토큰(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"

요청 / 응답

이 페이지는 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
현재 관리 토큰과 연결된 조직 ID입니다.
balancenumber
표시용 JSON 숫자로 된 현재 조직의 USD 잔액입니다.
balance_decimalstring
정산용 십진수 문자열로 된 현재 조직의 정확한 USD 잔액입니다.
total_rechargenumber
표시용 JSON 숫자로 된 조직의 총 성공 충전 금액(USD)입니다.
total_recharge_decimalstring
정산용 십진수 문자열로 된 조직의 정확한 총 성공 충전 금액(USD)입니다.
total_usednumber
표시용 JSON 숫자로 된 조직의 총 사용 금액(USD)입니다.
total_used_decimalstring
정산용 십진수 문자열로 된 조직의 정확한 총 사용 금액(USD)입니다.

인증

ManagementTokenAuth
AuthorizationBearer <token>

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

위치: header

응답

application/json

application/json

application/json

application/json