> ## Documentation Index
> Fetch the complete documentation index at: https://verifner.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Erreurs

> Le format des erreurs et la liste des codes.

Toutes les erreurs ont la même forme :

```json theme={null}
{ "error": { "code": "unreadable", "message": "front image too blurred (sharpness 4.2)" } }
```

Basez votre code sur `code`, qui est stable. `message` est une aide au débogage en anglais, qui peut changer.

## Codes

| HTTP | `code` | Cause | Que faire |
| - | - | - | - |
| 400 | `invalid_request` | Paramètre manquant ou mal formé, `front` absent, image de plus de 12 Mo | Corriger la requête |
| 413 | `invalid_request` | Corps JSON trop lourd (images en base64 au-delà de la limite) | Envoyer en multipart, ou réduire les images |
| 401 | `unauthorized` | Clé absente, mal formée, inconnue ou révoquée ; jeton client invalide | Vérifier la clé |
| 403 | `invalid_token` | Lien d'image expiré ou falsifié | Redemander une URL |
| 403 | `live_not_enabled` | Création d'une clé live avant l'activation du mode live | Contacter VerifNer |
| 404 | `not_found` | Vérification, session ou webhook inconnu dans votre organisation | Vérifier l'identifiant |
| 409 | `session_completed` | La session a déjà produit une vérification | Ouvrir une nouvelle session |
| 409 | `session_expired` | La session a dépassé sa durée de validité | Ouvrir une nouvelle session |
| 410 | `image_gone` | Image jamais conservée (clé de test) ou supprimée après la durée de rétention | |
| 422 | `unreadable` | Photo trop floue pour être lue | Demander une nouvelle photo |
| 422 | `not_an_image` | Fichier qui n'est pas une image JPEG, PNG ou WebP | Envoyer une image |
| 422 | `extraction_failed` | Le document n'a pas pu être lu | Réessayer, ou demander une meilleure photo |
| 429 | `rate_limited` | Trop de requêtes | Attendre, puis réessayer |
| 5xx | `internal` | Incident de notre côté | Réessayer avec la même `Idempotency-Key` |

Une erreur `4xx` n'est pas facturée et n'enregistre aucune vérification.

## Réessayer

Réessayez automatiquement les `429` et les `5xx`, avec un délai croissant (1 s, 2 s, 4 s…) et la même `Idempotency-Key`. Ne réessayez pas les autres `4xx` sans corriger la requête.