TokenLab

Gestion

Obtenir le solde de l’organisation

Retourne les totaux de solde actuels de l’organisation pour le jeton de gestion.

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

Aperçu

Cet endpoint retourne les totaux de solde actuels de l’organisation associée au jeton de gestion. Il utilise la même référence actuelle de solde d’organisation que la facturation et le règlement.

Remarques

  • Les champs monétaires prennent uniquement en charge l’USD.

  • Les champs monétaires sont renvoyés en USD. Utilisez balance, total_recharge et total_used pour l’affichage ; utilisez balance_decimal, total_recharge_decimal et total_used_decimal pour le rapprochement exact.

Exemple

Requête

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

Demande / Réponse

Cette page fournit le schéma OpenAPI et des exemples de requêtes à copier. Envoyez les requêtes de gestion depuis votre terminal ou votre client avec un Management Token ; l’envoi direct n’est pas disponible sur cette page.

Exemple de réponse

Réponse

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

Champs importants

objectstring
Toujours organization_balance.
organization_idstring
Organisation associée au token de gestion actuel.
balancenumber
Solde actuel de l’organisation en USD sous forme de JSON number pour l’affichage.
balance_decimalstring
Solde actuel exact de l’organisation en USD sous forme de chaîne décimale pour le rapprochement.
total_rechargenumber
Montant total des recharges réussies en USD sous forme de JSON number pour l’affichage.
total_recharge_decimalstring
Montant total exact des recharges réussies en USD sous forme de chaîne décimale pour le rapprochement.
total_usednumber
Dépenses d’usage cumulées de l’organisation en USD sous forme de JSON number pour l’affichage.
total_used_decimalstring
Dépenses d’usage cumulées exactes de l’organisation en USD sous forme de chaîne décimale pour le rapprochement.

Autorisation

ManagementTokenAuth
AuthorizationBearer <token>

Authentification par jeton de gestion. Créez ou gérez vos jetons de gestion dans Dashboard > API > Management Tokens.

Emplacement: header

Réponse

application/json

application/json

application/json

application/json