Skip to main content
GET
Export workflow run data
Verwende die Workflow-Ausführungs-Export-API, um Daten zu Workflow-Ausführungen und Node-Ausführungen als JSON zu exportieren. Jede Zeile enthält Metadaten zur Ausführung, den Status der Node-Ausführung und detaillierte Ausführungsdaten, wenn du auf die Node zugreifen kannst.

Bevor du startest

Bevor du startest, stelle sicher, dass du Folgendes hast:
  • Workspace-API-Schlüssel: Erstelle einen Workspace-API-Schlüssel mit dem WORKFLOW_API Scope unter Einstellungen > Workspace > Produkte > API. Persönliche API-Schlüssel unterstützen nur die Completion APIs. Mehr dazu findest du unter Persönliche API-Keys.
  • Workflow-Zugriff: Der API-Schlüssel muss zu einem Workflow-Besitzer oder Bearbeiter gehören. Workspace-Administratoren können auch ohne eine Workflow-Freigabe auf Workflows zugreifen. Eine Freigabe mit der Rolle Benutzer gewährt keinen Zugriff auf diesen Endpunkt, auch nicht für Workspace-Administratoren.
Der API-Schlüssel eines Workspace-Administrators kann Daten im gesamten Workspace exportieren. Ein API-Schlüssel eines Nichtadministrators ist auf Workflows begrenzt, die diese Person besitzt oder bearbeiten darf. Gewähre diesen Scope nur vertrauenswürdigen Personen.

Basis-URL

Endpunkt

Du erhältst eine Zeile für jede Node-Ausführung. Eine Ausführung ohne Node-Ausführungen gibt eine Zeile mit null in den Node-Feldern zurück.

Authentifizierung

Sende deinen API-Schlüssel als Bearer-Token:
cURL
Ersetze bei einem Dedicated Deployment https://api.langdock.com durch die Basis-URL deines Deployments.

Parameter

Füge bei vollständigen Zeitstempeln Z oder einen expliziten UTC-Offset hinzu. Ein Zeitstempel ohne Zeitzone wird in der lokalen Zeitzone des Servers interpretiert. Beide Datumswerte sind erforderlich. Die API verwendet keinen Standardzeitraum. Du erhältst alle Node-Ausführungen einer passenden Workflow-Ausführung, auch wenn die Node-Ausführung außerhalb des Zeitraums liegt.

Antwort

Du erhältst ein data-Array mit flachen Zeilen zu Workflow-Ausführungen und Node-Ausführungen:
Erfolg
Die Zeilen sind vom ältesten zum neuesten Erstellungszeitpunkt der Workflow-Ausführung und dann nach dem Erstellungszeitpunkt der Node-Ausführung sortiert. Der Endpunkt verwendet keine Pagination. Verwende einen kürzeren Zeitraum, um die Antwort zu verkleinern.

Antwortfelder

Die Felder input und output sind bei Ausführungsdaten, die älter als 30 Tage sind, null. Alle fünf Payload-Felder sind null, wenn der Endpunkt keinen Zugriff auf die Node-Daten feststellen kann. Das kann passieren, wenn dein Workflow-Zugriff die von der Ausführung verwendete Action oder den Agenten nicht einschließt. Die API setzt data_redacted in diesem Fall auf true. Bei Payload-Werten über 16.000 Bytes gibt die API einen Kürzungsmarker zurück. Der Marker enthält ein _truncated-Objekt mit den Feldern originalBytes, maxBytes und message. Die Antwort enthält nicht die Identität der Person oder Gruppe, die eine Ausführung gestartet hat.

Limits und Aufbewahrung

  • Jede Anfrage kann bis zu 10.000 Workflow-Ausführungen exportieren.
  • Eingabe- und Ausgabedaten werden 30 Tage lang aufbewahrt.
  • Die Payload-Daten einer Antwort sind auf 8.000.000 Bytes begrenzt.
Wenn eine Anfrage mehr als 10.000 Ausführungen enthält, gibt sie 400 Bad Request mit dem Code WORKFLOW_RUN_EXPORT_LIMIT_EXCEEDED zurück. Wenn die Payload-Daten 8.000.000 Bytes überschreiten, gibt sie 400 Bad Request mit dem Code WORKFLOW_RUN_EXPORT_TOO_LARGE zurück. Verwende einen kürzeren Zeitraum, um beide Fehler zu vermeiden.

Rate Limits

Der Endpunkt erlaubt 500 Anfragen pro Minute je Workspace und API-Schlüssel. Anfragen über diesem Limit geben 429 Too Many Requests zurück.

Fehlerbehandlung

Fehler
Fehlerhafte Query-Parameter geben {"message":"Invalid request","errors":[...]} ohne code-Feld zurück. Ein ungültiges Datum oder ein to-Wert vor from gibt code: "BAD_REQUEST" zurück.
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 den Best Practices für API-Schlüssel.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Pfadparameter

workflowId
string<uuid>
erforderlich

ID of the workflow to export.

Abfrageparameter

from
string
erforderlich

Start of the export range. Use an ISO 8601 date or timestamp. A date-only value starts at 00:00:00.000 UTC.

to
string
erforderlich

End of the export range. Use an ISO 8601 date or timestamp. A date-only value ends at 23:59:59.999 UTC.

Antwort

Workflow run export

Flattened workflow run and node execution rows.

data
object[]
erforderlich