Nouvelles tentatives

Les réseaux réessaient, et une nouvelle tentative ne doit jamais générer un second document ni consommer un second numéro de facture. Vous n’avez rien à faire pour cela : si une requête identique à l’une de celles envoyées dans les 10 dernières minutes arrive de nouveau (même modèle, mêmes valeurs, même titre, même clé), elle répond avec le document produit par la première, en HTTP 200 avec replayed: true au lieu de 201.

La correspondance est volontairement exacte : changez le titre et c’est un nouveau document. Si vous préférez décider vous-même de ce qui compte comme la même requête, envoyez un en-tête Idempotency-Key avec n’importe quelle chaîne qui lui est propre ; la clé est retenue 24 heures et une nouvelle tentative qui la porte répond avec le même document quel que soit le corps. Dans les deux cas, une nouvelle tentative qui arrive pendant que la première requête est encore en cours attend quelques secondes puis répond idempotency_in_flight.