Webhooks

Webhooks lar et annet system få beskjed når planen endrer seg, uten å spørre runorder om og om igjen. Endres en hendelse, sendes en signert JSON-POST til adressen du har oppgitt.

Dette er integrasjonsverktøy, ikke varsling til mennesker. Skal noen få en e-post, hører det hjemme under Varsler.

Sette opp et abonnement

Legg til abonnement ber om fire ting:

• Mottaker-URL — adressen som skal motta POST-ene.
• Omfang — Globalt (alle hendelser i denne organisasjonen) eller Per produksjon, hvor du velger hvilken.
• Tillatte hendelsestyper — en pipe-separert liste, for eksempel event.created|event.updated. Står den tom, får du alle typer.

URL-en må være HTTPS. Vanlig http:// avvises, og det samme gjør vertsnavn som peker mot et internt eller privat nettverk — begge deler ville lagt data åpent på veien.

Hemmeligheten vises én gang

Når abonnementet opprettes, får du en hemmelighet. Den vises bare denne ene gangen. Mottakeren bruker den til å verifisere headeren X-runorder-Signature, som er HMAC-SHA256(hemmelighet, body).

Lagre hemmeligheten med én gang

Lukker du siden uten å ta vare på den, finnes det ingen vei tilbake til verdien. Da må abonnementet opprettes på nytt.

Prøve og skru av

Test-fyr sender en testhendelse til mottakeren, slik at du kan se at den kommer fram før du stoler på oppsettet. Kvitteringen ber deg sjekke mottakerens logger — runorder gjetter ikke på om den andre siden var fornøyd.

Hvert abonnement viser Sist sendt med tidspunkt og statuskode. Deaktiver stopper leveringen uten å slette oppsettet; Aktiver starter den igjen. Slett fjerner abonnementet helt.