Export user usage data
Usage Export API
Nutzer-Nutzung exportieren
API-Endpunkt zum Exportieren von Nutzeraktivität, Nachrichten und Nutzungsmetriken.
POST
Export user usage data
Dieser Endpunkt exportiert Nutzeraktivitätsdaten. Welche identifizierenden Daten enthalten sind, hängt von den Datenschutzeinstellungen deines Workspaces ab.
Details zu Voraussetzungen und Rate Limits findest du in der Hauptdokumentation zur Usage Export API.
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.
Datenschutzhinweis
Wenn Daten auf Nutzerebene im Workspace deaktiviert sind, werden identifizierende Spalten wie Name und E-Mail aus dem Export ausgeschlossen.Enthaltene Daten
Standardmäßig gibt der Nutzer-Export eine Zeile pro Nutzer zurück.| Spalte | Beschreibung |
|---|---|
period_start | Startdatum des Berichts |
period_end | Enddatum des Berichts |
org_id | ID des Workspaces |
user_id | ID des Nutzers |
name | Name des Nutzers |
email | E-Mail des Nutzers |
role | Rolle des Nutzers |
joined_at | Datum des Workspace-Beitritts |
department | Abteilung |
company_name | Firmenname |
license_type | Aktuelle Lizenzstufe |
payg_limit_current | Aktuelles Extra-Usage-Limit |
payg_consumption_in_period | Extra-Usage-Verbrauch im Zeitraum |
payg_utilization_pct_current | payg_consumption_in_period / payg_limit_current |
messages_total | Gesamtzahl der Nachrichten |
messages_total_rank | Rang nach Gesamtnachrichten |
messages_chat | Nachrichten in normalen Chats |
messages_chat_rank | Rang nach Chat-Nachrichten |
messages_assistants | Nachrichten an Agenten |
messages_assistants_rank | Rang nach Agenten-Nachrichten |
assistants_messaged | Anzahl unterschiedlicher Agenten |
assistants_to_messages | JSON-Zuordnung von Agent-ID zu Nachrichtenanzahl |
messages_projects | Nachrichten in Projekten |
messages_projects_rank | Rang nach Projekt-Nachrichten |
projects_messaged | Anzahl unterschiedlicher Projekte |
projects_to_messages | JSON-Zuordnung von Projekt-ID zu Nachrichtenanzahl |
model_to_messages_total | JSON-Zuordnung von Modellname zu Nachrichtenanzahl |
action_messages | Durch Aktionen erzeugte Nachrichten |
action_messaged | Anzahl unterschiedlicher ausgelöster Aktionen |
action_to_messages | JSON-Zuordnung von Aktionsname zu Nachrichtenanzahl |
Zusätzliche Spalten für BYOK-Workspaces
| Spalte | Beschreibung |
|---|---|
total_input_tokens | Gesamte Input-Tokens |
total_output_tokens | Gesamte Output-Tokens |
cached_prompt_tokens | Cache-Read-Input-Tokens |
cache_creation_tokens | Cache-Write-Input-Tokens |
no_cache_tokens | Input-Tokens, die nicht aus dem Cache kamen |
total_cost_usd | Geschätzte Provider-Kosten in USD |
Gruppierter Export
Mitgroup_by=model erhältst du eine Zeile pro Nutzer und Modell.Autorisierungen
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Body
application/json