--- title: Prozess erstellen description: Erstellen Sie einen Human Token-Prozess auf der Human API — senden Sie ein Selfie (API Only) oder starten Sie die Human Token Journey — und erhalten Sie den humanToken in data.humanToken. canonical: https://developer.unico.io/de/human-token/api-reference/post-processes locale: de generated_by: markdown-export --- - [/de/](/de/) - API-Referenz - Prozess erstellen **Auf dieser SeiteProzess erstellenPOSTErstellen Sie einen Human Token-Prozess von Ihrem Back-End aus und erhalten Sie den humanToken in data.humanToken. Human Token läuft auf dem Endpunkt `POST /client/v1/process` der Human API. Mit den API Only-Flows (`api+humantoken`, `api+liveness+humantoken` und `api+liveness+humantoken+revalidation`) wird der Prozess in einem einzigen Aufruf erstellt und abgeschlossen: Die Antwort enthält das Ergebnis bereits in `data.humanToken`. Mit den Human Token Journey-Flows (`humantoken` und `humantoken+revalidation`) enthält die Antwort die `id` des Prozesses, einen `token` und den `link` der Journey, und das Ergebnis ist verfügbar, nachdem der Nutzer die Journey abgeschlossen hat. Die `+revalidation`-Flows erfordern ein `references`-Array mit einem zuvor erhaltenen `humanToken` zur Revalidierung. ### Flows​ Human Token wird in zwei Integrationsmodellen ausgeführt: **API Only** — Ihr Back-End sendet das Selfie in `imageBase64`. **Human Token Journey** — der Nutzer durchläuft die Human Token Journey im Web und kehrt zu Ihrer `callbackUri` zurück. FlowCapabilitiesPossible resultIntegration componentsrequiredExample`api+humantoken`[Human Token](/de/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken`Liveness[Human Token](/de/human-token/)PROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`api+liveness+humantoken+revalidation`Liveness[Human Token](/de/human-token/)RevalidationPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDAPIView example`humantoken`Liveness[Human Token](/de/human-token/)PROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example`humantoken+revalidation`Liveness[Human Token](/de/human-token/)RevalidationPROCESS_STATE_CREATEDPROCESS_STATE_FINISHEDPROCESS_STATE_FAILEDPROCESS_STATE_CANCELEDAPIWebView example ### Endpunkt​ UmgebungURL**Produktion**`POST https://humantoken.unico.app/client/v1/process` ### Request​ Headers HeaderWert`x-unico-accesskey``` (siehe [Authentifizierung](/de/human-token/get-started/authentication))`Content-Type``application/json` Body-Parameter FeldTypErforderlichBeschreibung`flow`stringjaHuman Token-Flow: `api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation` (API Only) oder `humantoken`, `humantoken+revalidation` (Human Token Journey). Siehe [Flows](#flows).`imageBase64`stringAPI OnlyDas von Ihrem Front-End erfasste und direkt gesendete Selfie, base64-kodiert. PNG, JPEG oder WebP, bis zu 800 KB. Befolgen Sie den [Aufnahmestandard](/de/human-token/additional-resources/capture-standard).`callbackUri`stringHuman Token JourneyURL, an die der Nutzer nach Abschluss der Journey weitergeleitet wird.`companyBranchId`stringneinBranch-Kennung. Wenn angegeben, verwendet der Prozess die Konfiguration des angegebenen Branches.`references`arrayRevalidierungs-FlowsArray von Referenzobjekten. Erforderlich für `+revalidation`-Flows. Jedes Objekt enthält `referenceType` (`REFERENCE_TYPE_HUMAN_TOKEN`) und `referenceContent` (den zuvor erhaltenen `humanToken`-Wert). ### Antworten​ 200 OK FeldTypBeschreibung`id`string (UUID)Prozesskennung. Verwenden Sie sie, um den Prozess über [Prozess abrufen](/de/human-token/api-reference/get-process) erneut abzurufen.`state`stringProzesszustand — siehe [Ergebnis interpretieren](#interpreting-the-result). Nur in den API Only-Flows.`token`stringToken des erstellten Prozesses, Sie können diesen verwenden, um die Journey SDK-Erfahrung zu öffnen. Nur in den Human Token Journey-Flows (`humantoken`, `humantoken+revalidation`).`link`stringURL der Human Token Journey: Leiten Sie den Nutzer dorthin. Nur in den Human Token Journey-Flows (`humantoken`, `humantoken+revalidation`).`data.​humanToken.​value`stringStabiler, opaker Bezeichner des Gesichts (bis zu 100 Zeichen). Dieselbe Person ergibt immer denselben Wert. Nur in den API Only-Flows (ohne Revalidierung).`data.​humanTokenMatch`string`"true"`, wenn das Selfie mit dem referenzierten `humanToken` übereinstimmt, andernfalls `"false"`. Nur im `+revalidation` API Only-Flow. Ergebnis interpretieren `state`BedeutungVorgehen`PROCESS_STATE_FINISHED``data.humanToken.value` gefüllt: echte Person, mit Human Token.Suchen Sie `value` in Ihren Datensätzen: Ist der Wert vorhanden, handelt es sich um einen wiederkehrenden Nutzer oder ein mögliches Duplikat; andernfalls um eine neue Person.`PROCESS_STATE_FINISHED`Kein `data.humanToken` oder leeres `value`: nicht eindeutig.Behandeln Sie das Ergebnis als nicht eindeutig. Speichern oder vergleichen Sie niemals einen leeren `value`; wiederholen Sie den Prozess oder lehnen Sie ihn ab, je nach Ihren Geschäftsregeln.`PROCESS_STATE_FAILED`Der Identifizierungsprozess ist fehlgeschlagen.Wiederholen Sie den Prozess oder lehnen Sie ihn gemäß Ihren Geschäftsregeln ab.`PROCESS_STATE_CREATED`Prozess erstellt.Warten Sie. Rufen Sie das Ergebnis später über [Prozess abrufen](/de/human-token/api-reference/get-process) ab.`PROCESS_STATE_CANCELED`Der Prozess wurde abgebrochen.Erstellen Sie einen neuen Prozess, falls der Nutzer noch verifiziert werden muss. WarnungPrüfen Sie immer, dass `data.humanToken.value` nicht leer ist, bevor Sie den Wert verwenden. ### Fehlercodes​ HinweisDer HTTP-Status, der zurückgegeben wird, wenn der Zugriffsschlüssel im Header `x-unico-accesskey` fehlt oder ungültig ist, wird noch bestätigt. Siehe [Authentifizierung](/de/human-token/get-started/authentication). 400 Bad Request403 Forbidden429 Too Many Requests500 Internal Server ErrorCodeMeldungBeschreibung`3`invalid flowWenn der angegebene Flow nicht existiert.`3`INVALID_IMAGEWenn das Bild kein gültiges Base64 ist oder wie ein Injection-Versuch aussieht.`3`IMAGE_TOO_LARGEWenn das Bild die maximale Größe von 800 KB überschreitet.`3`UNSUPPORTED_IMAGE_FORMATWenn das Bildformat nicht PNG, JPEG oder WebP ist.`3`MISSING_IMAGEWenn das Bild für diesen Flow erforderlich ist und nicht gesendet wurde.`3`INVALID_REQUESTWenn der Request-Body null ist oder nicht interpretiert werden kann.`9`monthly process limit of reached for this tenantWenn das monatliche Nutzungslimit erreicht wurde.`9`PROCESS_FAILEDWenn der Prozess während der Erstellung einen endgültigen Fehler erreicht hat.CodeMeldungBeschreibung`7`PERMISSION_DENIEDWenn die Anmeldedaten gültig, aber für diese Aktion nicht berechtigt sind.Rate-Limit erreicht. Wenn Ihr System einen HTTP-429-Fehler erhält, müssen Sie Mechanismen implementieren, um kaskadierende Ausfälle zu verhindern und eine Verschärfung der Einschränkung zu vermeiden. **Best Practices:** **Abkühlphase (Backoff):** Stoppen oder drosseln Sie nachfolgende Anfragen aus Ihrem System sofort. Wiederholen Sie fehlgeschlagene Anfragen nicht kontinuierlich in einer engen Schleife. **Warteschlange & Drosselung:** Puffern oder reihen Sie ausgehende Anfragen auf Ihrer Seite ein, um den Datenverkehr zu kontrollieren, bevor Sie sie erneut senden. **Exponentieller Backoff mit Jitter:** Erhöhen Sie beim erneuten Versuch die Wartezeit zwischen den Versuchen exponentiell (z. B. 1 s, 2 s, 4 s, 8 s) und fügen Sie eine kleine zufällige Verzögerung ("Jitter") hinzu, um einen Herdeneffekt zu vermeiden, bei dem alle in der Warteschlange befindlichen Anfragen exakt zur gleichen Millisekunde erneut versucht werden. WarnungDas kontinuierliche Ansprechen eines rate-limitierten Endpunkts ohne Backoff kann **die Einschränkungsperiode verlängern** und den operativen Durchsatz Ihres Systems erheblich beeinträchtigen. Eine ordnungsgemäße Drosselung der Anfragen auf Ihrer Seite gewährleistet eine reibungslosere und widerstandsfähigere Integration. Informationen zu Standardlimits, Erhöhung von Anfragen und weiteren Details finden Sie unter [Rate Limits](/de/developers/start/rate-limits).CodeMeldungBeschreibung`13`Internal failure! Try again laterWenn ein interner Fehler auftritt. Die vollständige Liste der Codes dieses Endpunkts finden Sie in der Referenz [Prozess erstellen](/de/developers/api-reference/post-processes#error-codes) der Human API. ### Nächste Schritte​ Speichern Sie den Wert von `humanToken` zusammen mit Ihrem Benutzerdatensatz, um dieselbe Person bei späteren Human Token-Aufrufen wiederzuerkennen. Um den Prozess erneut abzurufen, etwa für Audits oder den Support, verwenden Sie [Prozess abrufen](/de/human-token/api-reference/get-process). Zuletzt aktualisiert am 22. Okt. 2026**