---
title: API-Übersicht
description: Die Endpunkte von Human Plugin, wie sie zusammenhängen, die allgemeinen Antwortregeln und was die API nicht bietet.
canonical: https://developer.unico.io/de/human-plugin/api-reference/overview
locale: de
generated_by: markdown-export
---

# API-Übersicht

Drei Prozess-Endpunkte und zwei Health-Probes.

Human Plugin wird über reines HTTP auf dem von Ihnen konfigurierten Port bereitgestellt (Standard `8080`). Die Basis-URL ist die Adresse, unter der Sie den Container in Ihrem Netzwerk bereitstellen, zum Beispiel `http://human-plugin.internal:8080`.

| Methode | Pfad | Zweck |
| --- | --- | --- |
| `POST` | `/v1/processes` | [Einen Prozess erstellen](/de/human-plugin/api-reference/create-process), mit einem der [Flows](/de/human-plugin/api-reference/create-process#flows) |
| `GET` | `/v1/processes/{id}` | [Einen Prozess abrufen](/de/human-plugin/api-reference/get-process) |
| `GET` | `/v1/processes/{id}/selfie` | [Das Selfie abrufen](/de/human-plugin/api-reference/get-selfie) |
| `GET` | `/health/live` | Lebendigkeitsprüfung des Dienstes. Siehe [Health und Monitoring](/de/human-plugin/self-hosting/health-and-monitoring) |
| `GET` | `/health/ready` | Bereitschaft (Datenbank-Ping) |

Es gibt keinen Endpunkt zum Auflisten, Löschen oder Durchsuchen von Prozessen und keinen Webhook-Empfänger.

## Regeln, die für jeden Aufruf gelten

- **Kein Authentifizierungs-Header.** Human Plugin validiert Aufrufer nicht. Beschränken Sie stattdessen den Netzwerkzugriff: siehe [Netzwerk und Sicherheit](/de/human-plugin/self-hosting/networking-and-security).
- **Nur JSON**, mit Feldnamen in camelCase.
- **Antworten sind `Cache-Control: no-store`.**
- **Fehler** verwenden einen einheitlichen Umschlag, `{"message": "INVALID_REQUEST", "details": []}`. Siehe [Fehler und Wiederholungen](/de/human-plugin/api-reference/errors-and-retries).
- **`id` ist die Prozess-id von Human Plugin.** Bewahren Sie sie vom Erstellen auf: Damit lesen Sie den Prozess später.

## Typischer Ablauf

```mermaid
sequenceDiagram
  participant B as Your back-end
  participant H as Human Plugin
  B->>H: POST /v1/processes
  H-->>B: 201 + id, state, data
  B->>H: GET /v1/processes/{id}
  H-->>B: 200 + id, state, data (humanToken, ndocs)
```

Weiter: [Einen Prozess erstellen](/de/human-plugin/api-reference/create-process).