Hopp til innhold
Dokumentasjonsmeny

Webhook-oversikt

Motta, verifiser, bekreft og behandle Itemra-hendelser pålitelig.

Opprett en mottaker

Eksponer et HTTPS-endepunkt som kan lese den rå forespørselskroppen. Returner et vellykket svar raskt etter varig mottak, og behandle forretningsarbeidet asynkront. Hold endepunktet adskilt fra vanlige nettleserflyter.

Abonner bevisst

Opprett et abonnement bare for hendelsestypene integrasjonen bruker. Lagre signeringshemmeligheten i en hemmelighetstjeneste. Bruk testlevering før produksjonsbehandling aktiveres.

Verifiser hver levering

Valider signaturen med dokumentert algoritme, rå forespørselsbyte og abonnementets hemmelighet. Avvis manglende, ugyldige, gamle eller feil signaturer før hendelsen tolkes som pålitelige data.

Forvent nye forsøk og duplikater

Leveringen skjer minst én gang. Registrer hendelses-ID-en før behandling, og gjør håndteringen idempotent. Returner bare feilstatus når et nytt forsøk med samme levering kan hjelpe; gjentatte feil kan flyttes til feilkø.

Drift integrasjonen

Overvåk suksessrate, behandlingsforsinkelse, nye forsøk og feilkø. Roter hemmeligheter med planlagt overlapp, spill bare av hendelser på nytt etter at årsaken er rettet, og logg aldri signeringshemmeligheten eller hele sensitive data.