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
POST https://<din mottaker>/aktieX-Aktie-Event-Type: leadership.ceo_change.appointedX-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" } }}
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.
Eller les mer om API-et.