Webhooks: modtag begivenheder i realtid

Webhooks sender automatisk en besked til din server, når noget sker — så du slipper for at spørge API'et hele tiden. Webhooks kræver Pro eller højere.

Opret en webhook

1. Gå til Webhooks og klik Tilføj webhook.
2. Angiv din URL — den skal være HTTPS (fx https://din-app.dk/webhooks/addr).
3. Vælg de begivenheder, du vil modtage, fx:

• address.created — en ny adresse er oprettet
• address.updated — en adresse er ændret
• address.deleted — en adresse er nedlagt
• vej.updated — en vej er ændret
• postnummer.updated — et postnummer er ændret

Der findes også begivenheder for enheder, BBR, DAGI, kvote, abonnement og fakturering.

1. Gem. Kopiér den webhook-secret, der vises — den vises kun denne ene gang. Send derefter et test-event med Send test i leveringsloggen, så du kan se, at det virker.

Sikkerhed og pålidelighed

• Hver besked er signeret (HMAC-SHA256 i headeren X-Addr-Signature), så du kan verificere, at den kommer fra os. Se [Verificér en webhook](webhook-verificering).
• Svarer din server ikke med 2xx, prøver vi igen automatisk op til 8 gange med stigende mellemrum.
• Fejler en webhook vedvarende, deaktiverer vi den og giver dig besked. Du slår den til igen i webhook-listen ved at klikke på Auto-deaktiveret.

Brug Send test og leveringsloggen til at fejlsøge din modtager.