---
title: Codes d'erreur
description: Catalogue consolidé des codes d'erreur HTTP et de la plateforme pour les contrats Web & SDK, API et Magic Link.
canonical: https://developer.unico.io/fr/developers/start/error-codes
locale: fr
generated_by: markdown-export
---

- [/fr/](/fr/)
- [Commencer](/fr/developers/start/)
- Codes d'erreur

**Sur cette page# Codes d'erreur

Cette page constitue la source de vérité unique pour la gestion des erreurs. Les codes d'erreur spécifiques aux SDK sont documentés dans la page Gestion des erreurs de chaque SDK ; cette page couvre les erreurs au niveau du contrat API.
### Codes de statut HTTP​

CodeSignification`200 OK`La requête a réussi.`400 Bad Request`Le payload est mal formé ou des champs obligatoires sont manquants. Le corps identifie les champs problématiques.`401 Unauthorized`Authentification manquante, expirée ou invalide.`403 Forbidden`L'authentification est valide, mais le tenant n'est pas activé pour la ressource demandée (ex. : appel d'une capacité absente de votre `APIKEY`).`404 Not Found`La ressource n'existe pas ou n'appartient pas au tenant authentifié.`409 Conflict`La ressource existe, mais n'est pas dans l'état adéquat pour cette opération (ex. : récupération de documents d'un processus encore en cours).`410 Gone`La ressource existait, mais a été supprimée conformément à la politique de rétention (endpoints de récupération de documents), ou le processus existe mais s'est terminé en état d'erreur — voir [Récupérer un processus](/fr/developers/api-reference/get-process).`429 Too Many Requests`Vous avez atteint la [limite de débit](/fr/developers/start/rate-limits). Réessayez avec un backoff exponentiel.`5xx`Erreur de plateforme. Réessayez avec un backoff ; en cas de persistance, contactez le support avec le corps de la réponse et l'horodatage.
### Politique de réessai​

StatutDoit réessayer ?Comment`5xx`OuiBackoff exponentiel (1s, 2s, 4s, 8s, …). Plafonné à 5 tentatives.`429`OuiRespectez l'en-tête `Retry-After` si présent ; sinon, backoff exponentiel.`4xx` (autre)NonLa requête est incorrecte. Corrigez les données avant de réessayer.`401`ConditionnellementActualisez le jeton d'accès une fois. Si la nouvelle requête retourne également `401`, le problème est structurel — ne réessayez pas.
IdempotenceLa plateforme IDCloud n'expose actuellement pas de mécanisme de clé d'idempotence sur les endpoints de création. Soyez prudent lorsque vous réessayez [Créer un processus](/fr/developers/api-reference/post-processes) — une erreur réseau sur un `5xx` peut avoir réellement réussi côté serveur, et un nouvel essai créerait un processus en double. En cas de doute, récupérez les processus récents via votre ID de corrélation interne avant de réessayer.
### Où vivent les erreurs SDK​

Les catalogues d'erreurs du Android SDK, iOS SDK et Flutter SDK sont documentés dans la page **Gestion des erreurs** dédiée à chaque SDK :

[Android SDK > Gestion des erreurs](/fr/developers/sdks-and-tools/android/error-handling)
[iOS SDK > Gestion des erreurs](/fr/developers/sdks-and-tools/ios/error-handling)
[Flutter SDK > Gestion des erreurs](/fr/developers/sdks-and-tools/flutter/error-handling)

Ces pages couvrent les erreurs côté appareil (permission caméra refusée, délai de capture dépassé, réseau inaccessible sur l'appareil) — distinctes des erreurs côté API documentées ici.Dernière mise à jour le 8 oct. 2026**