Idempotensnyckel
En idempotensnyckel identifierar upprepningar av samma avsedda begäran. Område, lagringstid och API-regler avgör dess verkan.
En idempotensnyckel är en identifierare som klienten väljer och som en tjänst kan använda för att känna igen upprepningar av samma avsedda begäran. Målet är att undvika att en redan utförd affärsåtgärd utförs igen vid ett nytt försök. API-kontraktet avgör den konkreta verkan.
Bedöm en begäran med osäkert utfall på nytt
I en fiktiv portal bryts anslutningen efter en begäran om att skapa en order. Det är oklart om ERP-systemet redan har skapat ordern. Om tjänsten stöder detta skydd använder portalen samma nyckel vid ett lämpligt nytt försök. En ny nyckel skulle kunna leda till att en order till skapas.
Följ API:ets regler
Stripe beskriver olika idempotensregler för API v1 och v2. Headern Idempotency-Key är ett konkret exempel från denna leverantör. Kontrollera område, lagringstid och hantering av ändrade data i begäran. Samma nyckel ger inte tillåtelse för godtyckligt nytt innehåll och bevisar inte i sig att bearbetningen är avslutad.
Källor
Relaterade begrepp
- Händelse-idEtt händelse-id identifierar en händelse inom det avtalade området. En upprepad leverans behöver skiljas från en ny händelse.
- Omsändning av webhookOmsändning av webhook skickar ett meddelande igen. Avsiktlig återhämtning och replayattacker kräver olika kontroller.
- Transaktionell inboxEn transaktionell inbox använder beständiga meddelandeposter för att skydda lokal behandling mot dubbla leveranser.
- MeddelandekvittensEn meddelandekvittens talar om för brokern att en leverans har tagits emot eller behandlats enligt den överenskomna regeln.
- Jitter vid återförsökRetry-jitter varierar väntetider slumpmässigt för att sprida återförsök och minska samtidiga anrop från många klienter.
- TestkundmiljöEtt logiskt avgränsat kundområde i en multitenant-applikation, inrättat för kontroller.
Artiklar om ämnet
API:er & integration med ASES
ERP, CRM och webbutik smidigt sammankopplade