TokenLab

Quản lý

Lấy số dư tổ chức

Trả về các tổng số dư hiện tại của tổ chức cho management token.

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

Tổng Quan

Endpoint này trả về các tổng số dư hiện tại của tổ chức gắn với management token. Nó dùng cùng nguồn sự thật số dư tổ chức như billing và settlement.

Ghi Chú

  • Các trường tiền tệ chỉ hỗ trợ USD.

  • Các trường tiền tệ được trả về bằng USD. Dùng balance, total_recharge và total_used để hiển thị; dùng balance_decimal, total_recharge_decimal và total_used_decimal để đối soát chính xác.

Ví Dụ

Yêu cầu

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

Yêu Cầu / Phản Hồi

Trang này cung cấp schema OpenAPI và các ví dụ yêu cầu có thể sao chép. Hãy gửi yêu cầu quản lý từ terminal hoặc ứng dụng khách bằng Management Token; trang này không hỗ trợ gửi trực tiếp.

Ví dụ phản hồi

Phản hồi

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"
}

Trường quan trọng

objectstring
Luôn là organization_balance.
organization_idstring
Tổ chức gắn với management token hiện tại.
balancenumber
Số dư hiện tại của tổ chức bằng USD dưới dạng JSON number để hiển thị.
balance_decimalstring
Số dư hiện tại chính xác của tổ chức bằng USD dưới dạng chuỗi thập phân để đối soát.
total_rechargenumber
Tổng nạp thành công của tổ chức bằng USD dưới dạng JSON number để hiển thị.
total_recharge_decimalstring
Tổng nạp thành công chính xác của tổ chức bằng USD dưới dạng chuỗi thập phân để đối soát.
total_usednumber
Chi tiêu sử dụng tích lũy của tổ chức bằng USD dưới dạng JSON number để hiển thị.
total_used_decimalstring
Chi tiêu sử dụng tích lũy chính xác của tổ chức bằng USD dưới dạng chuỗi thập phân để đối soát.

Xác thực

ManagementTokenAuth
AuthorizationBearer <token>

Xác thực bằng Token quản lý. Tạo hoặc quản lý Token quản lý trong Dashboard > API > Management Tokens.

Vị trí: header

Phản hồi

application/json

application/json

application/json

application/json