Export workflow run data
Workflow-Ausführungs-Export-API
Workflow-Ausführungs-Export-API
Exportiere Daten zu Workflow-Ausführungen und Node-Ausführungen als JSON für Analysen und Debugging.
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.
Du erhältst eine Zeile für jede Node-Ausführung. Eine Ausführung ohne Node-Ausführungen gibt eine Zeile mit
Ersetze bei einem Dedicated Deployment
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.
Fehlerhafte Query-Parameter geben
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_APIScope 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.
Basis-URL
- Langdock Cloud
- Dedicated Deployment
Endpunkt
null in den Node-Feldern zurück.
Authentifizierung
Sende deinen API-Schlüssel als Bearer-Token:cURL
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 eindata-Array mit flachen Zeilen zu Workflow-Ausführungen und Node-Ausführungen:
Erfolg
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.
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 geben429 Too Many Requests zurück.
Fehlerbehandlung
Fehler
{"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
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Pfadparameter
ID of the workflow to export.
Abfrageparameter
Start of the export range. Use an ISO 8601 date or timestamp. A date-only value starts at 00:00:00.000 UTC.
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.