관리
조직 잔액 조회
관리 토큰에 연결된 조직의 현재 잔액 합계를 반환합니다.
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
현재 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