API-mekanikk
Webhook
En webhook er et HTTP-kall en tjeneste gjør til din adresse når noe skjer, i stedet for at du spør om og om igjen. Du oppgir en adresse, og hendelsen kommer som en POST.
Sist oppdatert
Mer om Webhook
Tre ting skiller en webhook som virker fra en som lager mer arbeid enn den sparer. Sjekk signaturen før du gjør noe med innholdet. Svar raskt med 2xx og gjør arbeidet i en kø etterpå, ellers regnes kallet som mislykket og prøves på nytt. Og tål at den samme hendelsen kommer to ganger, eller i en annen rekkefølge enn den skjedde.
Webhook i telkit
Du registrerer en https-adresse per bedrift eller per profil, og velger hendelsene, for eksempel sms.status, email.status og letter.status. Hver levering er signert etter Standard Webhooks-formatet, og du kan i tillegg slå på en Ed25519-signatur. Når du bytter hemmelig nøkkel, signerer den gamle videre i 24 timer.
Feiler leveringene, prøver telkit igjen. Etter fem dager med feil, eller et svar med 410 Gone, stopper telkit leveringene til adressen. Mislykkede leveringer kan sendes på nytt.