Skip to main content
Mit der Usage Export API können Workspace-Administratoren Nutzungsdaten für Nutzer, Agenten, API-Schlüssel, Projekte und Modelle exportieren. Nutze sie, wenn du Berichte automatisieren oder Daten in ein externes Analytics-System übertragen möchtest.
Du kannst diese Exporte auch direkt in der Langdock-Oberfläche erstellen. Mehr dazu findest du unter Nutzungsexporte.

Voraussetzungen

Um die Usage Export API zu nutzen, benötigst du:
  • Workspace-Admin-Berechtigung: Nur Workspace-Administratoren können API-Schlüssel mit Nutzungsexport-Berechtigung erstellen.
  • API-Schlüssel mit USAGE_EXPORT_API Scope: Spezielle Berechtigung für den Zugriff auf Nutzungsexporte.
Wichtiger Sicherheitshinweis: Nutzer mit Zugriff auf einen API-Schlüssel mit USAGE_EXPORT_API Scope können Workspace-Nutzungsdaten für alle Bereiche exportieren, auch wenn sie diese Daten normalerweise nicht in der Oberfläche sehen können. Gewähre diese Berechtigung nur vertrauenswürdigen Personen.

Programmatischer Export

Verfügbare Endpunkte

agents und assistants geben die gleichen Daten zurück. agents ist ein Alias.
Jeder Endpunkt unterstützt außerdem explizite Ausgabeformate:

Authentifizierung

Alle Anfragen benötigen Bearer-Token-Authentifizierung:

Anfrageformat

Die API nutzt die Uhrzeit aus dem date-Wert und interpretiert sie in der angegebenen timezone. Wenn du ein Z am Ende des date-Werts angibst, entfernt Langdock dieses automatisch, damit die Zeitzone nicht doppelt angewendet wird.
group_by ist optional. Unterstützte Werte hängen vom Exporttyp ab:

Antwortformat

CSV-Antwort

CSV-Endpunkte geben einen Dateipfad und eine Download-URL zurück:

JSON-Antwort

JSON-Endpunkte geben die Zeilen direkt zurück:

Fehlerantwort

Beispielanfrage

Export-Limits

Jede Anfrage an die Usage Export API kann bis zu 1.000.000 Nutzungszeilen verarbeiten. Dieses Limit gilt für die Standard-, CSV- und JSON-Endpunkte. Anfragen über diesem Limit geben 400 Bad Request mit dem Code USAGE_EXPORT_TOO_LARGE zurück. Exportiere jeweils einen Monat und füge die Ergebnisse anschließend zusammen.

Rate Limits

Die Usage Export API unterliegt einem Limit für Anfragen, das je Workspace und API-Key begrenzt wird. Das Token-Limit der Completion-Endpunkte gilt hier nicht.
  • Anfragen pro Minute: 500 Anfragen/Min

Details zu Endpunkten

Sicherheit und Datenschutz

Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen. Verwende API-Schlüssel serverseitig und speichere sie sicher. Mehr dazu findest du unter Best Practices für API-Schlüssel.