Hvad er Idempotency key?
Idempotency key er en unik nøgle, der gør det sikkert at gentage samme API-kald uden at oprette den samme handling flere gange. Det er ikke et login eller en adgangsnøgle. For kunden er værdien, at retries ikke skaber dubletter af kontakter, events, ordrer eller betalinger.
- 0
- Type: Teknisk proces eller integration
- 1
- Håndteres typisk af: Platform, udvikler eller serveransvarlig
- 2
- Vigtigt fordi: Det kan påvirke sending, imports, tracking, retries eller rapportering
Idempotency key er en unik nøgle, der gør det sikkert at gentage samme API-kald uden at oprette den samme handling flere gange.
Indholdsfortegnelse
Tilbage til topHvad er Idempotency key?
Idempotency key er en unik nøgle, der gør det sikkert at gentage samme API-kald uden at oprette den samme handling flere gange.
Det er ikke et login eller en adgangsnøgle. For kunden er værdien, at retries ikke skaber dubletter af kontakter, events, ordrer eller betalinger.
Det bør derfor forklares klart i produktet med status for Idempotency key, seneste kørsel, fejlbesked og anbefalet handling, så brugeren ikke skal læse serverlogs.
Hvorfor er det vigtigt?
Idempotency key er vigtigt, fordi baggrundsopgaver, integrationer og serverprocesser skal køre stabilt, også når en opgave tager længere tid end en almindelig sidevisning.
For ejeren er værdien ved Idempotency key ikke selve teknikken. Værdien er, at udsendelser, imports, retries, tracking og rapporter kan behandles mere stabilt og med tydelig fejlstatus.
Hvis Idempotency key fejler, kan emails blive forsinket, data mangle, rapporter halte bagefter eller support få sværere ved at forklare hvad der skete.
Sådan bruger du det i praksis
Som afsender behøver du normalt ikke arbejde direkte med Idempotency key hver dag. Det vigtigste er, at systemet viser om status er korrekt, hvad der eventuelt mangler, og hvem der bør handle på det.
Ved ændringer i Idempotency key bør man teste den konkrete arbejdsgang bagefter, fx import, sending, retries, tracking eller rapportopdatering afhængigt af emnet.
En typisk fejl med Idempotency key er at lade baggrundsopgaver fejle uden synlig status. Det kan få brugeren til at tro, at en import, sending eller rapport er færdig, selv om den ikke er det.
FAQ om Idempotency key
Hvad betyder Idempotency key?
Idempotency key er en unik nøgle, der gør det sikkert at gentage samme API-kald uden at oprette den samme handling flere gange.
Skal en nyhedsbrevsejer selv arbejde med Idempotency key?
Som regel ikke i hverdagen. Det håndteres ofte af platformen, en udvikler eller serveransvarlig.
Hvorfor skal man kende Idempotency key?
Fordi status eller fejl i baggrundsopgaver kan forklare forsinkede udsendelser, manglende data, trackingfejl eller rapporter der ikke er opdateret.
Hvad bør et godt system vise?
Det bør vise status, forklaring, seneste kørsel, fejlbesked og om opgaven kan genkøres.
Hvad er en typisk fejl?
En typisk fejl er at lade baggrundsopgaver fejle uden synlig status, så kunden tror at import, sending eller rapportering er færdig.