Gerenciamento

Obter Saldo do Workspace

Obtenha o saldo, recargas e gastos de uso do Workspace atual.

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

Visão geral

Retorna o saldo, o total de recargas e o total de gastos de uso para o Workspace associado ao token de gerenciamento.

Notas

  • Os campos monetários são apenas em USD.

  • Os valores são retornados em USD. Use balance_decimal, total_recharge_decimal e total_used_decimal para cálculos exatos.

Exemplo

Requisição

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

Solicitação / Resposta

Esta página fornece o esquema OpenAPI e exemplos de solicitação copiáveis. Envie solicitações de gerenciamento a partir do seu terminal ou cliente com um Management Token; o envio direto não está disponível nesta página.

Exemplo de resposta

Resposta

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

Campos importantes

objectstring
Sempre organization_balance.
organization_idstring
Organização associada ao token de gerenciamento atual.
balancenumber
Saldo atual da organização em USD como um número JSON para exibição.
balance_decimalstring
Saldo atual exato da organização em USD como uma string decimal para reconciliação.
total_rechargenumber
Valor total de recarga bem-sucedida da organização em USD como um número JSON para exibição.
total_recharge_decimalstring
Valor total exato de recarga bem-sucedida da organização em USD como uma string decimal para reconciliação.
total_usednumber
Total de gastos de uso da organização em USD como um número JSON para exibição.
total_used_decimalstring
Total exato de gastos de uso da organização em USD como uma string decimal para reconciliação.

Autorização

ManagementTokenAuth
AuthorizationBearer <token>

Autenticação por token de gerenciamento. Crie ou gerencie Tokens de Gerenciamento em Dashboard > API > Management Tokens.

Local: header

Resposta

application/json

application/json

application/json

application/json