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_APIScope: Spezielle Berechtigung für den Zugriff auf Nutzungsexporte.
Programmatischer Export
Verfügbare Endpunkte
Der veraltete dataType
assistants liefert dieselben Daten wie agents. POST /export/assistants bleibt als Alias verfügbar.Authentifizierung
Alle Anfragen benötigen Bearer-Token-Authentifizierung:Anfrageformat
Die API nutzt die Uhrzeit aus demdate-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 geben400 Bad Request mit dem Code USAGE_EXPORT_TOO_LARGE zurück. Die Fehlermeldung nennt das Zeilenlimit, und details enthält es als limit. Wähle einen kürzeren Zeitraum 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
- Nutzer-Nutzung exportieren
- Agenten-Nutzung exportieren
- API-Schlüssel-Nutzung exportieren
- Projekt-Nutzung exportieren
- Modell-Nutzung exportieren