Skip to main content
Un réseau coupé au mauvais moment, et vous ne savez pas si la vérification a été faite. Avec l’en-tête Idempotency-Key, vous pouvez renvoyer exactement la même requête sans risque.
  • Première fois : la vérification est faite, réponse 201.
  • Même clé ensuite : VerifNer ne refait rien et renvoie la vérification d’origine, avec le statut 200 et l’en-tête Idempotent-Replayed: true. Elle n’est pas facturée une seconde fois.

​
Les règles

  • La clé est propre à votre organisation, quelle que soit la clé API qui l’envoie. Jusqu’à 255 caractères.
  • Elle n’expire pas. Une clé réutilisée des mois plus tard renvoie toujours la même vérification.
  • Le contenu de la requête n’est pas comparé : une clé déjà utilisée renvoie la vérification d’origine, même avec d’autres images.
  • Une requête refusée (400, 422) n’enregistre rien : vous pouvez réessayer avec la même clé.

​
Choisir la clé

Prenez un identifiant stable de la tentative dans votre système, par exemple l’identifiant du dossier suivi d’un numéro de tentative. Si la personne reprend ses photos, changez de clé : sinon vous recevrez l’ancien résultat.
Les sessions du SDK web n’ont pas besoin de cet en-tête : une session ne peut produire qu’une vérification.