Erreurs - VerifNer

Toutes les erreurs ont la même forme :

{ "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.