Réessayer un envoi sans jamais l’envoyer deux fois.
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.