Gå til hovedinnhold

Hendelser

info

Det gjøres oppmerksom på at konsumenter i tillegg må lytte til endringer via MatrikkelAPI for å få med seg endringer på selve bygningen og bruksenheten som f.eks. sletting, riving, sammmenslåing. Les mer under “Om tjenesten”.

Hendelser gir deg muligheten til å sjekke om det har skjedd endringer i den egenregistrerte dataene siden sist du hentet informasjon. Dette er et effektivt verktøy for å holde systemet ditt oppdatert uten å måtte hente data kontinuerlig. Når en endring skjer, blir hendelsen registrert, og du kan hente ut nyeste versjon av bruksenheten.

Hendelsene er "tynne", hvilket betyr at du kun får vite at en endring har skjedd, hvilke type endringer det er, og hvilke felt som er berørt - ikke hva selve endringen innebærer.

Det finnes fire forskjellige hendelsestyper for egenregistrering:

  • lagtTil: Et nytt felt har blitt lagt til
  • slettet: Et felt slettes helt, har aldri vært gjeldende
  • avsluttet: Et felt har sluttet å gjelde, og vil nå ha en gyldigTil dato
  • korrigert: Metadataen (gyldigFra-årstall eller kildemateriale) på et felt har blitt oppdatert

Det er kun én hendelseslogg som virksomheter innenfor alle rettighetspakker kan søke om. Merk derfor at ikke alle endringer nødvendigvis er relevante for din rettighetspakke, da hendelsen kan berøre enkelte datafelter som er utilgjengelige for deg.

Tilgang til hendelser er ikke inkludert i de øvrige rettighetspakkene og det kreves derfor en egen rettighetspakke/scope.

Scope i Maskinporten​

Følgende scope må brukes i Maskinporten-tokenet ved kall til API-et for hendelseslogg: kartverk:eiendomsregisteret:bygning.virksomhet.hendelser

Hendelser og oppslagstjenester​

Konsumenter som ønsker å hente et større datasett kan gjøre dette ved å kombinere hendesesloggen med oppslagstjenestene. Vi anbefaler å lytte etter hendelser fra ønsket sekvensnummer og benytte bulk API-et (oppslagstjeneste) til å hente egenregistrert data for et sett av bruksenheter.

Merk! Oppslagstjenestene gir alltid siste versjon av de egenregistrerte dataene. For å unngå å gjøre unødvendig mange kall for samme bruksenhet, bør konsumenter fjerne duplikate bruksenhetId-er fra hendelsene før de benytter oppslagstjenestene.