Zum Hauptinhalt springen

Executions API

Überwachen und verwalten Sie Workflow-Ausführungen.

Ausführungen auflisten​

Rufen Sie alle Workflow-Ausführungen ab.

GET /executions

Query-Parameter​

  • workflow_id (optional): Filter nach Workflow-ID
  • status (optional): Filter nach Status (running, success, failed)
  • page (optional): Seitennummer (Standard: 1)
  • limit (optional): Anzahl pro Seite (Standard: 20, Max: 100)
  • from (optional): Startdatum (ISO 8601)
  • to (optional): Enddatum (ISO 8601)

Beispiel-Request​

curl -X GET "https://api.exeoflow.com/v1/executions?workflow_id=wf_123456&status=success" \
  -H "Authorization: Bearer IHR_API_KEY"

Beispiel-Response​

{
  "success": true,
  "data": {
    "executions": [
      {
        "id": "exec_abc123",
        "workflow_id": "wf_123456",
        "workflow_name": "Mein Workflow",
        "status": "success",
        "started_at": "2024-01-20T10:00:00Z",
        "finished_at": "2024-01-20T10:02:30Z",
        "duration": 150000
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "pages": 8
    }
  }
}

Ausführung abrufen​

Rufen Sie Details zu einer spezifischen Ausführung ab.

GET /executions/{execution_id}

Beispiel-Request​

curl -X GET "https://api.exeoflow.com/v1/executions/exec_abc123" \
  -H "Authorization: Bearer IHR_API_KEY"

Beispiel-Response​

{
  "success": true,
  "data": {
    "id": "exec_abc123",
    "workflow_id": "wf_123456",
    "workflow_name": "Mein Workflow",
    "status": "success",
    "started_at": "2024-01-20T10:00:00Z",
    "finished_at": "2024-01-20T10:02:30Z",
    "duration": 150000,
    "input": {
      "user_id": "12345"
    },
    "output": {
      "result": "success",
      "message": "Workflow erfolgreich ausgeführt"
    },
    "steps": [
      {
        "node_id": "node_1",
        "node_name": "Webhook Trigger",
        "status": "success",
        "started_at": "2024-01-20T10:00:00Z",
        "finished_at": "2024-01-20T10:00:05Z",
        "duration": 5000
      }
    ]
  }
}

Ausführung abbrechen​

Brechen Sie eine laufende Ausführung ab.

POST /executions/{execution_id}/cancel

Beispiel-Request​

curl -X POST "https://api.exeoflow.com/v1/executions/exec_abc123/cancel" \
  -H "Authorization: Bearer IHR_API_KEY"

Beispiel-Response​

{
  "success": true,
  "data": {
    "id": "exec_abc123",
    "status": "cancelled",
    "message": "Ausführung wurde abgebrochen"
  }
}

Ausführung wiederholen​

Wiederholen Sie eine fehlgeschlagene Ausführung.

POST /executions/{execution_id}/retry

Beispiel-Request​

curl -X POST "https://api.exeoflow.com/v1/executions/exec_abc123/retry" \
  -H "Authorization: Bearer IHR_API_KEY"

Beispiel-Response​

{
  "success": true,
  "data": {
    "execution_id": "exec_def456",
    "status": "running",
    "started_at": "2024-01-20T11:00:00Z"
  }
}

Ausführungs-Logs abrufen​

Rufen Sie detaillierte Logs einer Ausführung ab.

GET /executions/{execution_id}/logs

Query-Parameter​

  • level (optional): Filter nach Log-Level (debug, info, warning, error)

Beispiel-Request​

curl -X GET "https://api.exeoflow.com/v1/executions/exec_abc123/logs" \
  -H "Authorization: Bearer IHR_API_KEY"

Beispiel-Response​

{
  "success": true,
  "data": {
    "logs": [
      {
        "timestamp": "2024-01-20T10:00:00Z",
        "level": "info",
        "node_id": "node_1",
        "message": "Workflow gestartet"
      },
      {
        "timestamp": "2024-01-20T10:00:05Z",
        "level": "info",
        "node_id": "node_1",
        "message": "Webhook empfangen"
      }
    ]
  }
}

Ausführungs-Statistiken​

Rufen Sie Statistiken zu Workflow-Ausführungen ab.

GET /executions/stats

Query-Parameter​

  • workflow_id (optional): Filter nach Workflow-ID
  • from (optional): Startdatum (ISO 8601)
  • to (optional): Enddatum (ISO 8601)

Beispiel-Request​

curl -X GET "https://api.exeoflow.com/v1/executions/stats?workflow_id=wf_123456" \
  -H "Authorization: Bearer IHR_API_KEY"

Beispiel-Response​

{
  "success": true,
  "data": {
    "total_executions": 1500,
    "successful": 1350,
    "failed": 100,
    "cancelled": 50,
    "success_rate": 90.0,
    "average_duration": 125000,
    "total_duration": 187500000
  }
}

Status-Werte​

Mögliche Status-Werte für Ausführungen:

  • pending: Ausführung wartet auf Start
  • running: Ausführung läuft
  • success: Ausführung erfolgreich abgeschlossen
  • failed: Ausführung fehlgeschlagen
  • cancelled: Ausführung abgebrochen
  • timeout: Ausführung durch Timeout abgebrochen

Nächste Schritte​