Chuyển đến nội dung chính

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ệ được trả về bằng USD. Dùng balance, total_rechargetotal_used để hiển thị; dùng balance_decimal, total_recharge_decimaltotal_used_decimal để đối soát chính xác.

Ví Dụ

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

Sử dụng bảng điều khiển OpenAPI tương tác ở trên để xem schema chính xác.

Ví dụ phản hồi

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

object
string
Luôn là organization_balance.
organization_id
string
Tổ chức gắn với management token hiện tại.
balance
number
Số dư hiện tại của tổ chức bằng USD dưới dạng JSON number để hiển thị.
balance_decimal
string
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_recharge
number
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_decimal
string
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_used
number
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_decimal
string
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.