Zum Hauptinhalt springen
POST
/
export
/
assistants
Export assistant usage data
curl --request POST \
  --url https://api.langdock.com/export/assistants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": {
    "date": "2024-01-01T00:00:00.000Z",
    "timezone": "UTC"
  },
  "to": {
    "date": "2024-01-31T23:59:59.999Z",
    "timezone": "UTC"
  }
}
'
{
  "success": true,
  "data": {
    "filePath": "assistants-usage/workspace-id/assistants-usage-2024-01-01-2024-01-31-abc12345.csv",
    "downloadUrl": "https://storage.example.com/signed-url",
    "dataType": "assistants",
    "recordCount": 1250,
    "dateRange": {
      "from": "2024-01-01T00:00:00.000Z",
      "to": "2024-01-31T23:59:59.999Z"
    }
  }
}
Dieser Endpunkt exportiert Agenten-Nutzungsdaten einschließlich der Nachrichtenanzahl pro Agent, Anzahl aktiver Nutzer und Nutzungstrends über Zeit.

Enthaltene Daten

Der Agenten-Export enthält:
  • Anzahl der Nachrichten pro Agent
  • Aktive Nutzer pro Agent
  • Nutzungstrends über Zeit
  • Agenten-Konfigurationsdetails
  • Performance-Metriken

Beispiel-Antwort

Die erfolgreiche Antwort enthält eine signierte Download-URL für die CSV-Datei mit deinen Agenten-Nutzungsdaten.
Weitere Informationen: Details zu Voraussetzungen, Rate Limits und Export-Größenlimits findest du in der Haupt-Usage Export API Dokumentation.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Header

Authorization
string
erforderlich

API key as Bearer token with USAGE_EXPORT_API scope. Format "Bearer YOUR_API_KEY"

Body

application/json

Request body for usage export endpoints

from
object
erforderlich

Start date and timezone for the export

to
object
erforderlich

End date and timezone for the export

Antwort

Export successful

Successful response from usage export endpoints

success
boolean
erforderlich

Indicates if the export was successful

Beispiel:

true

data
object
erforderlich

Export data information