Idempotensnøgle
En idempotensnøgle identificerer gentagelser af den samme tilsigtede anmodning. Område, opbevaring og API-regler bestemmer dens virkning.
En idempotensnøgle er et id valgt af klienten, som en tjeneste kan bruge til at genkende gentagelser af den samme tilsigtede anmodning. Målet er at undgå, at en allerede udført forretningshandling udføres igen ved et nyt forsøg. API-kontrakten fastlægger den konkrete virkning.
Vurdér en anmodning med usikkert udfald igen
I en fiktiv portal afbrydes forbindelsen efter en anmodning om ordreoprettelse. Det er uklart, om ERP-systemet allerede har oprettet ordren. Understøtter tjenesten denne beskyttelse, bruger portalen samme nøgle ved et passende nyt forsøg. En ny nøgle kan udløse endnu en oprettelse.
Følg API'ets regler
Stripe beskriver forskellige idempotensregler for API v1 og v2. Headeren Idempotency-Key er et konkret eksempel fra denne udbyder. Kontroller område, opbevaring og håndtering af ændrede anmodningsdata. Samme nøgle giver ikke tilladelse til vilkårligt nyt indhold og er ikke i sig selv dokumentation for afsluttet behandling.
Kilder
Relaterede begreber
- Hændelses-idEt hændelses-id identificerer en hændelse inden for det aftalte område. En gentagen levering skal skelnes fra en ny hændelse.
- Genafsendelse af webhookGenafsendelse af webhook sender en meddelelse igen. Bevidst genopretning og replay-angreb kræver forskellige kontroller.
- Transaktionel inboxEn transaktionel inbox bruger varige meddelelsesregistreringer til at beskytte lokal behandling mod dobbelte leveringer.
- MeddelelseskvitteringEn meddelelseskvittering fortæller brokeren, at en levering er modtaget eller behandlet efter den aftalte regel.
- Jitter ved genforsøgRetry-jitter varierer ventetider tilfældigt for at sprede genforsøg og mindske samtidige forespørgsler fra mange klienter.
- TestkundemiljøEt logisk afgrænset kundeområde i en multitenant-applikation, indrettet til kontroller.
Artikler om emnet
Snitflader & integration med ASES
ERP, CRM og webshop forbundet ordentligt