Webhooks – Selskapsendringer rett inn i systemene dine

Aktie sender selskaper og hendelser til CRM, ERP eller egne systemer når noe endrer seg. Hver levering er signert, blir sendt på nytt hvis noe feiler, og kan spores i leveringshistorikken.

Mottakere og utvalg settes opp i webhook-konsollen i Aktie. Ta kontakt for tilgang.

  • HMAC-SHA256-signert
  • At-least-once med idempotency-nøkkel
  • Retry og dead letter
  • Forhåndsvisning og leveringshistorikk
Eksempel på en levering
POST https://<din mottaker>/aktie
X-Aktie-Event-Type: leadership.ceo_change.appointed
X-Aktie-Signature: v1,alg=HMAC-SHA256,hash=…
X-Aktie-Idempotency-Key: …
{
"event_type": "leadership.ceo_change.appointed",
"entity_id": "000000087",
"data": {
"reason": "Ny daglig leder registrert",
"company": {
"name": "Leverandør 087 AS",
"municipality_name": "Bergen",
"nace_code": "43.210",
"ceo": { "name": "Kari Nordmann" }
}
},
"metadata": { "webhook": { "name": "Kritiske leverandører" } }
}
Eksempel. Selskapet er oppdiktet. Hele kontrakten står i webhook-dokumentasjonen.

Velg hva som sendes.

Tre typer leveranser, alt etter hva systemet ditt skal gjøre.

  • Endringer

    Alle endringer i valgte deler av registeret, for eksempel nye selskaper eller nye roller, uten videre filter.

  • Hendelser som passer et filter

    Tolkede hendelser, som ny daglig leder eller konkurs, for selskapene som passer filteret ditt.

  • Målgrupper

    Selskaper som passer et utvalg, for eksempel en bransje i et område. Enten slik de er nå, eller når noe skjer hos dem.

Send med en gang, etter en plan eller fortløpende. Eller hold kandidatene tilbake til du har sett over dem.

Selskapsprofilen følger med.

Ta med selskapets profil i hver levering, slik den er når leveringen lages.

  • Navn
  • Adresse og kommune
  • Næringskode
  • Ansatte
  • E-post, telefon og nettside
  • Daglig leder
  • Styreleder
  • Siste regnskap

Leveranser du kan stole på.

Mottakeren kan sjekke hver levering, og ingenting forsvinner hvis noe feiler.

  • Signert

    Hver levering har tidsstempel, nonce og HMAC-SHA256-signatur, så mottakeren kan sjekke at den kommer fra Aktie.

  • Minst én gang

    Hver hendelse har en fast ID og en idempotency-nøkkel, så mottakeren kan se bort fra duplikater.

  • Nye forsøk ved feil

    Ved nettverksfeil, tidsavbrudd, 408, 429 og 5xx prøver Aktie igjen, og respekterer Retry-After.

  • Ingenting forsvinner

    Leveringer som feiler etter siste forsøk, blir lagt til side og kan sendes på nytt.

  • Bare HTTPS

    Kun HTTPS på port 443. Private adresser og omdirigeringer blir avvist.

  • Nøkkel som kan byttes

    Signeringsnøkkelen vises én gang, og nøkkelbytte er versjonert.

Kontroll før noe sendes.

Du ser hva som vil bli sendt før mottakeren får noe.

  • Forhåndsvisning

    Se hvilke selskaper som passer utvalget, uten at noe blir sendt.

  • Test forbindelse

    Send en signert test til mottakeren før du slår på leveringen.

  • Leveringshistorikk

    Se hver levering og svaret fra mottakeren.

Spørsmål og svar

Hvordan verifiserer jeg signaturen?
Signaturen er HMAC-SHA256, med tidsstempel og nonce i egne headere. Verifiser mot de eksakte rå request-bytene, og avvis gamle tidsstempler og nonce-er du har sett før.
Hvordan håndterer jeg duplikater?
Leveransen er at-least-once. X-Aktie-Event-ID og X-Aktie-Idempotency-Key er stabile på tvers av nye forsøk, og payload-bytene er de samme hver gang.
Hva skjer når mottakeren feiler?
Nettverksfeil, timeout, 408, 429 og 5xx gir nye forsøk, og Retry-After respekteres. Andre 4xx regnes som permanente. Etter siste forsøk havner leveransen i dead letter og kan sendes på nytt.
Hvordan håndteres endringer i formatet?
Leveransene er versjonert med X-Aktie-Event-Version og X-Aktie-API-Version, så du ser hvilken kontrakt hver levering følger.
Hva koster det?
Prisen følger utvalg og volum. Ta kontakt, så får du et tilbud.

Fortell oss hvor endringene skal.

Vi setter opp mottakeren og utvalget sammen med deg, og sender en signert testlevering.

Kontakt oss

Eller les mer om API-et.