Velkommen til Medlemsdataoverførsel – Webhook API
Dette dokumentationssite er til udviklere, der ønsker at integrere Medlemsdataoverførsel via webhooks. Her finder du relevant information, eksempler og tekniske beskrivelser, så du nemt kan implementere automatiseret udveksling af medlemsdata mellem DI og egne systemer.
Hvad er Medlemsdataoverførsel?
Medlemsdataoverførsel er DI's nye løsning for automatiseret udveksling af medlemsdata, når der sker relevante ændringer vedrørende medlemmer. Du kan modtage beskeder om indmeldelser, udmeldelser, ændringer eller andre events direkte i dit system. Når du vælger at abonnere på webhooks, erstatter det din nuværende overførselsmetode, som enten er mails med pdf eller XML-fil overførsel.
Hvorfor webhook?
Webhooks sikrer, at dine systemer automatisk bliver opdateret, når der sker ændringer. Du slipper for selv at hente data løbende og får besked med det samme, når der er relevante ændringer.
Sådan bruger du dokumentationssitet
Her på dokumentationssitet kan du finde:
- En oversigt over tilgængelige webhooks og events
- Skemaer og eksempler på payloads for hvert event
- OpenAPI-beskrivelser til integration og validering
- Vejledning til håndtering af sikkerhed, genkørsler og versionering
Sådan kommer du i gang
- Registrér dit endpoint hos DI – send din HTTPS-URL, ønskede events og kontaktinfo.
- Implementér et endpoint, der accepterer HTTP POST med JSON og returnerer 200 OK.
- Brug OpenAPI-specifikationerne for de enkelte webhooks for nem integration.
- Følg anbefalingerne for sikkerhed og håndtering af dubletter/genkørsler.