Idempotentie
Het antwoord dat nooit aankomt.
Een verbinding valt weg, een proxy loopt in een time-out — en uw programma weet niet of er geschreven is. Zonder garantie zijn er twee keuzes, beide fout: het record verliezen of het tweemaal aanmaken.
Hoe het werkt.
U kiest per bedoelde schrijfactie één waarde — een UUID volstaat — en stuurt die in de header. De eerste aanroep doet het werk; elke herhaling krijgt hetzelfde record terug, zonder dat er een tweede ontstaat.
Hoe dat eruitziet.
Dezelfde drie regels, zo vaak u wilt. Bij de tweede poging antwoordt KRONENWERK met de klant van de eerste.
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"}Drie regels.
Zelfde inhoud
U krijgt hetzelfde record terug, gelezen zoals de eerste keer.
Andere inhoud
Geweigerd. Een sleutel staat voor precies één bedoeling; stilzwijgend antwoorden zou iets bevestigen dat niet gebeurd is.
Geldigheid
24 h — daarna telt dezelfde waarde weer als nieuw werk
Waarom de header verplicht is.
Een vrijblijvende garantie beschermt juist de aanroepers die geen bescherming nodig hadden. Een dubbele klant valt niemand op tot een factuur naar de verkeerde kopie gaat, weken later.