Workflow-Ausführungsliste abrufen
Workflow-Ausführungsliste abrufen
Dient zum Abrufen der Liste der Ausführungsprotokolle eines Workflows. Der Workflow wird automatisch über den API Key authentifiziert und bestimmt; eine zusätzliche workflow_id ist nicht erforderlich.
| ID-Name | Beschreibung |
|---|---|
| log_id | ID des Workflow-Ausführungsprotokolls. |
| workflow_run_id | ID eines einzelnen Workflow-Durchlaufs, dient zur Identifizierung einer Workflow-Ausführung. |
| input | Eingabe dieses Workflow-Durchlaufs. |
| output | Ausgabe dieses Workflow-Durchlaufs. |
Methode
GET
URL
https://api-${endpoint}.gptbots.ai/v1/workflow/run/logs
Authentifizierung
Die Authentifizierung des Aufrufs erfolgt mit dem Workflow API Key.
Anfrage
Beispiel
curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/workflow/run/logs?conversation_type=API&user_id=your_user_id&start_time=1785125443602&end_time=1785125447498&page=1&page_size=10' \
-H 'Authorization: Bearer ${API Key}'
curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/workflow/run/logs?conversation_type=API&user_id=your_user_id&start_time=1785125443602&end_time=1785125447498&page=1&page_size=10' \
-H 'Authorization: Bearer ${API Key}'
Dieser Codeblock im schwebenden Fenster
Header
| Feld | Typ | Beschreibung |
|---|---|---|
| Authorization | Bearer ${API Key} | Authentifiziert den Aufruf mit Authorization: Bearer ${API Key}; verwenden Sie bitte den Workflow API Key. |
Anfrageparameter
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| conversation_type | string | Ja | Quelltyp der Ausführung. Unterstützt: ALL, API, AGENT, SHARE, C_WORKFLOW. Testläufe (DEBUG) werden nicht unterstützt. |
| user_id | string | Nein | Benutzerkennung, dient zum Filtern der Workflow-Ausführungen eines bestimmten Benutzers. |
| start_time | number | Ja | Startzeit der Abfrage, Timestamp in Millisekunden. |
| end_time | number | Ja | Endzeit der Abfrage, Timestamp in Millisekunden. |
| page | number | Ja | Seitennummer, beginnend bei 1. |
| page_size | number | Ja | Anzahl pro Seite, Wertebereich 10-100. |
Antwort
Beispiel
{
"list": [
{
"log_id": "6a66da44435da934b2e67e49",
"workflow_run_id": "6a66da44435da934b2e67e49",
"input": "{}",
"output": "{\"output\":\"{\\\"text\\\":\\\"Workflow output text\\\",\\\"image\\\":[],\\\"audio\\\":[]}\"}"
}
],
"total": 1
}
{
"list": [
{
"log_id": "6a66da44435da934b2e67e49",
"workflow_run_id": "6a66da44435da934b2e67e49",
"input": "{}",
"output": "{\"output\":\"{\\\"text\\\":\\\"Workflow output text\\\",\\\"image\\\":[],\\\"audio\\\":[]}\"}"
}
],
"total": 1
}
Dieser Codeblock im schwebenden Fenster
Erfolgsantwort
| Feld | Typ | Beschreibung |
|---|---|---|
| list | array | Liste der Workflow-Ausführungsprotokolle. |
| total | number | Gesamtzahl der Einträge, die den Abfragebedingungen entsprechen. |
| list[].log_id | string | ID des Workflow-Ausführungsprotokolls. |
| list[].workflow_run_id | string | ID eines einzelnen Workflow-Durchlaufs. |
| list[].input | string | Eingabe, JSON-String. |
| list[].output | string | Ausgabe, JSON-String. |
Fehlerantwort
| Feld | Typ | Beschreibung |
|---|---|---|
| code | int | Fehlercode. |
| message | string | Fehlerdetails. |
Fehlercodes
| Code | Message |
|---|---|
| 40000 | Parameterfehler |
| 40001 | Zu viele Anfragen |
| 40101 | Header Authorization is empty |
| 40127 | Developer authentication failed |
