---
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/developers/start/error-codes
locale: de
generated_by: markdown-export
---

- [/de/](/de/)
- [Start](/de/developers/start/)
- Fehlercodes

**Auf dieser Seite# Fehlercodes

Diese Seite ist die einzige Wahrheitsquelle für die Fehlerbehandlung. SDK-spezifische Fehlercodes sind auf der Seite Fehlerbehandlung des jeweiligen SDKs dokumentiert; diese Seite behandelt Fehler auf der Ebene des API-Vertrags.
### HTTP-Statuscodes​

CodeBedeutung`200 OK`Anfrage erfolgreich.`400 Bad Request`Nutzlast ist fehlerhaft oder erforderliche Felder fehlen. Der Body gibt die problematischen Felder an.`401 Unauthorized`Authentifizierung fehlt, ist abgelaufen oder ungültig.`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).`404 Not Found`Die Ressource existiert nicht oder gehört nicht zum authentifizierten Mandanten.`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).`410 Gone`Die Ressource existierte, wurde aber gemäß der Aufbewahrungsrichtlinie gelöscht (Dokumentenabruf-Endpunkte), oder der Prozess existiert, endete jedoch in einem Fehlerzustand — siehe [Prozess abrufen](/de/developers/api-reference/get-process).`429 Too Many Requests`Sie haben das [Rate-Limit](/de/developers/start/rate-limits) überschritten. Wiederholen Sie den Versuch mit exponentiellem Backoff.`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.
### 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 [Prozess erstellen](/de/developers/api-reference/post-processes) — 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 Android SDK, iOS SDK und Flutter SDK sind auf der dedizierten Seite **Fehlerbehandlung** jedes SDKs dokumentiert:

[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**