---
title: Fehlercodes
description: Konsolidierter Katalog von HTTP- und Plattformfehlercodes für die Verträge Web & SDK, API und Magic Link.
canonical: https://developer.unico.io/de/dual-api/developers/api-reference/error-codes
locale: de
generated_by: markdown-export
---

- [/de/](/de/)
- [API-Referenz](/de/dual-api/developers/api-reference/)
- Fehlercodes

**Auf dieser Seite# Fehlercodes

Diese Seite ist die einzige Wahrheitsquelle für die Fehlerbehandlung. SDK-spezifische Fehlercodes sind auf der Seite [Fehlerbehandlung](/de/dual-api/developers/sdks-and-tools/web/web-sdk/error-handling) des jeweiligen SDKs dokumentiert; diese Seite behandelt Fehler auf der Ebene des API-Vertrags.
### HTTP-Statuscodes​

CodeBedeutungWo er auftritt`200 OK`Anfrage erfolgreich.Alle Verträge.`201 Created`Ressource erstellt (selten; die meisten Erstellungen geben `200` zurück).API-Vertrag.`400 Bad Request`Nutzlast ist fehlerhaft oder erforderliche Felder fehlen. Der Body gibt die problematischen Felder an.Alle Verträge.`401 Unauthorized`Authentifizierung fehlt, ist abgelaufen oder ungültig.Alle Verträge.`403 Forbidden`Die Authentifizierung ist gültig, aber der Mandant ist für die angeforderte Ressource nicht aktiviert (z. B. Aufruf einer Fähigkeit, die nicht in Ihrem `APIKEY` enthalten ist).Web & SDK, API.`404 Not Found`Die Ressource existiert nicht oder gehört nicht zum authentifizierten Mandanten.Alle Verträge.`409 Conflict`Die Ressource existiert, befindet sich aber nicht im richtigen Zustand für diesen Vorgang (z. B. Abrufen von Dokumenten aus einem noch laufenden Prozess).Web & SDK, API.`410 Gone`Die Ressource existierte, wurde aber gemäß der Aufbewahrungsrichtlinie gelöscht (Dokumentenabruf-Endpunkte), oder der Prozess existiert, endete jedoch im Fehlerzustand — siehe [Prozess abrufen](/de/dual-api/developers/api-reference/api/get-process).Dokumentenabruf-Endpunkte; API Prozess abrufen.`429 Too Many Requests`Sie haben das [Rate-Limit](/de/dual-api/developers/api-reference/rate-limits) überschritten. Wiederholen Sie den Versuch mit exponentiellem Backoff.Alle Verträge.`5xx`Plattformfehler. Wiederholen Sie den Versuch mit Backoff; wenn das Problem anhält, wenden Sie sich mit dem Antwort-Body und dem Zeitstempel an den Support.Alle Verträge.
### Authentifizierungsfehler (`401`)​

UrsacheSymptomFalscher privater Schlüssel (Assertion mit dem falschen Schlüssel signiert)`401`, `Authentication failed (1.2.21)``aud` stimmt nicht mit der Umgebungs-URL überein`401``exp`-Claim liegt in der Vergangenheit`401`, `Authentication failed`Nicht unterstützter Algorithmus (verwenden Sie `RS256`)`401`Gemischte Sandbox-/Produktions-Anmeldedaten`401`, obwohl Anmeldedaten korrekt aussehenFehlender `APIKEY`-Header (nur API-Vertrag)`401`Ungültiger `x-api-key` (nur Magic Link)`401`
Siehe [Authentifizierung > Häufige Fehler](/de/dual-api/developers/api-reference/authentication#error-codes) für die vollständige Fehlerbehebungs-Checkliste.
### Ergebnisse auf Fähigkeitsebene (`200` mit negativem Ergebnis)​

Ein `200 OK` bedeutet **nicht**, dass der Nutzer die Verifizierung bestanden hat — es bedeutet, dass die Plattform die Arbeit abgeschlossen hat. Die für den Nutzer sichtbare Entscheidung befindet sich im Antwort-Body, nicht im HTTP-Status:
FeldNegativer WertWo er erscheint`process.result``PROCESS_RESULT_FAILED`Web & SDK`process.authenticationInfo.livenessResult``NO`Web & SDK`liveness``2`API`unicoId.result``no`API`data.response.unico.result``NOT_APPROVED`Magic Link
### Wiederholungsrichtlinie​

StatusWiederholen?Wie`5xx`JaExponentieller Backoff (1s, 2s, 4s, 8s, …). Maximal 5 Versuche.`429`Ja`Retry-After`-Header beachten, sofern vorhanden; andernfalls exponentieller Backoff.`4xx` (sonstige)NeinDie Anfrage ist fehlerhaft. Korrigieren Sie die Eingabe, bevor Sie es erneut versuchen.`401`BedingtAktualisieren Sie das Zugriffstoken einmal. Wenn die neue Anfrage ebenfalls `401` zurückgibt, ist das Problem strukturell — nicht erneut versuchen.
IdempotenzDie IDCloud-Plattform bietet derzeit keinen Idempotenzschlüssel-Mechanismus für Erstellungs-Endpunkte. Seien Sie vorsichtig beim Wiederholen von `POST /client/v1/process` oder `POST /processes/v1` — ein Netzwerkfehler bei einem `5xx` kann serverseitig tatsächlich erfolgreich gewesen sein, und ein erneuter Versuch würde einen doppelten Prozess erstellen. Rufen Sie im Zweifelsfall aktuelle Prozesse anhand Ihrer internen Korrelations-ID ab, bevor Sie es erneut versuchen.
### Wo SDK-Fehler dokumentiert sind​

Die Fehlerkataloge des Web SDK, Android SDK, iOS SDK und Flutter SDK sind auf der dedizierten Seite **Fehlerbehandlung** jedes SDKs dokumentiert:

[Web SDK > Fehlerbehandlung](/de/dual-api/developers/sdks-and-tools/web/web-sdk/error-handling)
[Android SDK > Fehlerbehandlung](/de/developers/sdks-and-tools/android/error-handling)
[iOS SDK > Fehlerbehandlung](/de/developers/sdks-and-tools/ios/error-handling)
[Flutter SDK > Fehlerbehandlung](/de/developers/sdks-and-tools/flutter/error-handling)

Diese umfassen geräteseitige Fehler (Kamerazugriff verweigert, Capture-Timeout, Netzwerk auf dem Gerät nicht erreichbar) — getrennt von den hier dokumentierten API-seitigen Fehlern.Zuletzt aktualisiert am 8. Okt. 2026**