Teknisk beskrivelse av REST-tjenestene i Åpne Data fra Enhetsregisteret - Work in progress
Ordbok
Enhetsregisteret
Register over grunndata om juridiske personer og andre enheter. Enhetsregisteret tildeler organisasjonsnummer for entydig identifisering av enheter.
Organisasjonsnummer
Nisifret nummer som entydig identifiserer enheter i Enhetsregisteret.
Enhet
Enhet på øverste nivå i registreringsstrukturen i Enhetsregisteret. Eksempelvis enkeltpersonforetak, foreninger, selskap, sameier og andre som er registrert i Enhetsregisteret. Identifiseres med organisasjonsnummer.
Underenhet
Enhet på laveste nivå i registreringsstrukturen i Enhetsregisteret. En underenhet kan ikke eksistere alene og har alltid knytning til en hovedenhet. Identifiseres med organisasjonsnummer.
Organisasjonsform
Organisasjonsform er virksomhetens formelle organisering og gir retningslinjer overfor blant annet ansvarsforhold, skatt, revisjonsplikt, rettigheter og plikter.
Næringskode
Næringskoder på brreg.no
Standard for næringsgruppering
Versjonering
Du kan velge major versjon ved å spesifisere HTTP Accept-headeren. Bruk headeren spesifisert i tabellen under. Hvis versjon ikke spesifiseres, vil man få siste versjon.
API Header / application/vnd.enhetsregisteret.v1+json /organisasjonsformer application/vnd.enhetsregisteret.organisasjonsform.v1+json
Strategi
Vi skal normalt ikke bryte bakoverkompabiliteten med våre brukere. Likevel kan det være nødvendig i enkelte situasjoner, av for eksempel juridiske årsaker eller vedlikehold, å gjøre endringer som medfører et slikt brudd. Vi vil i dette tilfellet versjonere tjenesten slik at nyeste versjon vil være tilgjengelig sammen med forrige versjon.
Dersom man ikke benytter versjonering i accept header, vil man få siste versjon.
Eldre versjon vil anses som utdatert/deprecated, og vil på sikt bli tatt bort. Ved behov for denne typen endringer vil vi forsøke å gi bruker god tid, og varsle om endringen i forkant. Se punkt om varsling.
Når innføres ny versjon
Vi vil innføre en ny versjon når vi introduserer en endring som påvirker bakoverkompabiliteten. Mindre endringer og patcher vil ikke medføre versjonsendring i header.
Når fjernes en versjon
Vi vil legge ut varsel/driftsmeldinger i god tid på følgende steder:
Eksempel på endring som medfører versjonering:
-
Fjerne eller endre navn på et attributt i HTTP-responsen.
-
Fjerne eller endre navn på et REST endepunkt.
Endringslogg
Versjon Dato Endring 1.1.0 14. august 2018 Ny tjeneste /oppdateringer/enheter og /oppdateringer/underenheter 1.0.0 6. april 2018 Produksjonssetting av ny åpne data tjeneste for Enhetsregisteret