Idempotens: prøv igjen uten å sende to ganger

Slik virker det

Send en nøkkel du lager selv i headeren Idempotency-Key. Første gang utfører vi kallet og lagrer svaret under nøkkelen. Kommer den samme nøkkelen igjen, får du det lagrede svaret tilbake med headeren Idempotency-Replayed: true, og ingenting blir gjort på nytt.

curl -X POST "https://api.telkit.no/v1/sms" \  -H "Authorization: Bearer $TELKIT_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: ordre-2041-hentemelding" \  -d '{  "profile": "nettbutikken",  "to": "+4791234567",  "text": "Hei! Pakken din er klar til henting."}'

const response = await fetch("https://api.telkit.no/v1/sms", {  method: "POST",  headers: {    Authorization: `Bearer ${process.env.TELKIT_API_KEY}`,    "Content-Type": "application/json",    "Idempotency-Key": "ordre-2041-hentemelding",  },  body: JSON.stringify({    profile: "nettbutikken",    to: "+4791234567",    text: "Hei! Pakken din er klar til henting.",  }),});const answer = await response.json();

• Lag nøkkelen fra noe du allerede har: ordrenummeret og hva meldingen gjelder, for eksempel ordre-2041-hentemelding. Da gir et nytt forsøk etter en omstart den samme nøkkelen.
• Bruk en ny nøkkel for hver ny handling, også når teksten er den samme.
• Svaret er lagret i 24 timer.

Kall som krever nøkkelen

Kall som sender, ringer eller reserverer penger, avviser kallet uten nøkkel med idempotency_key_required. Det gjelder blant annet:

• POST /v1/sms, POST /v1/email, POST /v1/letters og kampanjene
• POST /v1/calls og handlinger i en samtale som legger til en deltaker, leser opp, spør innringeren, flytter eller setter over
• POST /v1/transcription/jobs og POST /v1/transcription/sessions

API-referansen merker hver operasjon som tar nøkkelen. Der den er valgfri, anbefaler vi den likevel for alt som endrer noe.

Når nøkkelen blir avvist