Verwaltung

Organisationsguthaben abrufen

Gibt die aktuellen Guthabensummen der Organisation für das Management-Token zurück.

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

Übersicht

Dieser Endpunkt gibt die aktuellen Guthabensummen der Organisation zurück, die mit dem Management-Token verknüpft ist. Er verwendet dieselbe Quelle der Wahrheit für Organisationsguthaben wie Abrechnung und Settlement.

Hinweise

  • Geldbetragsfelder unterstützen ausschließlich USD.

  • Monetäre Felder werden in USD zurückgegeben. Verwenden Sie balance, total_recharge und total_used für die Anzeige; für exakte Abrechnung verwenden Sie balance_decimal, total_recharge_decimal und total_used_decimal.

Beispiel

Anfrage

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

Anfrage / Antwort

Diese Seite enthält das OpenAPI-Schema und kopierbare Anfragebeispiele. Senden Sie Verwaltungsanfragen mit einem Management Token über Ihr Terminal oder Ihren Client; direktes Senden ist auf dieser Seite nicht verfügbar.

Antwortbeispiel

Antwort

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

Wichtige Felder

objectstring
Immer organization_balance.
organization_idstring
Organisation des aktuellen Management-Tokens.
balancenumber
Aktuelles Organisationsguthaben in USD als JSON number für die Anzeige.
balance_decimalstring
Exaktes aktuelles Organisationsguthaben in USD als Dezimalzeichenfolge für die Abrechnung.
total_rechargenumber
Gesamtsumme erfolgreicher Organisationsaufladungen in USD als JSON number für die Anzeige.
total_recharge_decimalstring
Exakte Gesamtsumme erfolgreicher Organisationsaufladungen in USD als Dezimalzeichenfolge für die Abrechnung.
total_usednumber
Kumulierte Nutzungsausgaben der Organisation in USD als JSON number für die Anzeige.
total_used_decimalstring
Exakte kumulierte Nutzungsausgaben der Organisation in USD als Dezimalzeichenfolge für die Abrechnung.

Autorisierung

ManagementTokenAuth
AuthorizationBearer <token>

Management-Token-Authentifizierung. Erstellen oder verwalten Sie Management-Token unter Dashboard > API > Management Tokens.

Ort: header

Antwort

application/json

application/json

application/json

application/json