Skip to main content
Envoyez un en-tête Idempotency-Key (8 à 255 caractères) sur chaque envoi. Il protège d’un double envoi quand une réponse se perd — délai dépassé, coupure réseau — et que votre service réessaie.
  • Même clé, même demande : l’API rend le même message, sans rien écrire ni débiter.
  • Même clé, autre demande (autre texte, autre numéro…) : 409 CONFLICT.
  • La clé vaut pour un projet et un environnement.
Tirez la clé de votre propre identifiant métier (commande-48213-confirmation) plutôt que d’un aléa refait à chaque essai : c’est ce qui rend le réessai sûr.

Un client qui réessaie bien

Un client minimal, sans dépendance (Node 18+) : il garde la même clé d’un essai à l’autre et ne réessaie que ce qui peut l’être.