Idempotence
La réponse qui n'arrive jamais.
Une connexion tombe, un relais dépasse son délai — et votre programme ignore si l'écriture a eu lieu. Sans garantie, deux options, toutes deux mauvaises: perdre l'enregistrement ou le créer deux fois.
Comment cela fonctionne.
Vous choisissez une valeur par écriture voulue — un UUID suffit — et l'envoyez dans l'en-tête. Le premier appel travaille; toute répétition renvoie le même enregistrement, sans en créer un second.
Ce que cela donne.
Les mêmes trois lignes, autant de fois que vous voulez. À la seconde tentative, KRONENWERK renvoie le client de la première.
POST https://kronenwerk.org/api/extern/v1/customers\nAuthorization: Bearer greif_live_…\nIdempotency-Key: 6f1c2a8e-4b3d-4a21-9d77-0c5e1f9b2a44\n\n{"name":"Kellermann Elektrotechnik GmbH","email":"buchhaltung@kellermann.de","street":"Am Sandtorkai 41","postalCode":"20457","city":"Hamburg","country":"DE"}Trois règles.
Même contenu
Vous récupérez le même enregistrement, relu comme la première fois.
Contenu différent
Refusé. Une clé désigne une seule intention; y répondre en silence confirmerait ce qui n'a pas eu lieu.
Durée de vie
24 h — ensuite, la même valeur redevient une nouvelle opération
Pourquoi l'en-tête est obligatoire.
Une garantie facultative protège précisément ceux qui n'en avaient pas besoin. Un client dupliqué passe inaperçu jusqu'à ce qu'une facture parte au mauvais doublon, des semaines plus tard.