...
Grunnboken: Norges offentlige register over tinglyste rettigheter og heftelser i fast eiendom og borettslagsandeler.
Matrikkelen: Norges offisielle eiendomsregister. Inneholder oversikt over alle eiendommer, boliger/bygninger og adresser.
Folkeregisteret: Norges offisielle personregister. Inneholder nøkkelopplysninger om alle personer som er eller har vært bosatt i Norge.
Enhetsregisteret: Enhetsregisteret samordner grunndata om enheter i næringslivet og offentlig sektor.
Posten: Oversikt over alle poststeder i Norge.
SSB: Norges offisielle statistikk relatert til økonomi, befolkning og samfunnet på nasjonalt, regionalt og lokalt nivå.
Landbruksregisteret: Gir informasjon om ressursgrunnlag, lokalisering og eierforhold på landbrukseiendommer i Norge.
Stedsnavnsregisteret: Norges offisielle register over stedsnavn i offentlig bruk
Riksantikvaren: Offisielle databaser over fredete kulturminner og kulturmiljøer i Norge.
Miljødirektoratet: informasjon om forurensning i grunnen og hvor det er mistanke om forurensning i Norge
Andre: Lovdata (konsesjonsforhold), NVE (ras og flomsoner), Statens kartverk (kartgrunnlag), m.fl.
Kom i gang
For å få en god forståelse for alt Realty sitt REST API har å tilby kan man lese gjennom resten av dokumentet. Men dersom man bare vil komme i gang er det en enkel oppskrift her.
Bruk av EDR Realty RestAPI
...
Dokumentasjon Swagger: Velg «swagger» under «Eiendom» og du kunne se og prøve ut tjenestene v.h.a. swagger-brukergrensesnittet (Swagger er et verktøy for dokumentasjon og samhandling resttjenester). Se https://beta-api.ambita.com/api-landingpage/swagger2//realty/v1/assets/lib/swagger-ui/index.html?url=https://beta-api.ambita.com/realty/api-docs
Testklient: Ved hjelp av testklienten kan en enkelt prøve ut tjenestene for søk oppslag, samt benytte lenker videre til relaterte tjenester. For å benytte testklienten fult ut må en installere en JSON-viewer i nettleseren en benytter. Se: https://beta-api.ambita.com/realty/v1
Ordboken: EDR Realty RestAPI benytter engelsk. Om en ønsker å se norske begreper den integrerte ordboktjenesten benyttes:
Fra engelsk til norsk: https://beta-api.ambita.com/realty/v1/dictionary/?languageFrom=En&contentType=html
Fra norsk til engelsk: https://beta-api.ambita.com/realty/v1/dictionary/?languageFrom=No
Dette kan også benyttes indirekte til å oversette et svar i JSON til norsk for enhver ressurs ved å legge til parameter:AcceptLanguage:Norwegian. (Denne funksjonen er for øyeblikket ikke tilgjengelig!)
...
Ambita sine APIer bruker en egenimplementert autentisering som følger OAuth2 spesifikasjonen . (se https://oauth.net/2/). Alle kall mot APIet må inneholde en header parameter som ser slik ut:
...
Se: Swagger UI create token for dokumentasjon på selve tjenesten.PS
! Merk at alle brukere av APIet vil få tildelt egne klienter for bruk mot BETA miljø og PROD miljø. Prøver man å bruke en BETA klient i produksjon vil Autentiseringstjenesten gir tilgang til alle Ambita sine APIer. Hvilke eksakte tilganger man har er styrt av scopes (se https://oauth.net/2/scope/). En klient har et sett med scopes som blir tilordnet alle tokens som opprettes. Et scope kan f.eks. være realty.basic som gir tilgang til alle basistjenestene i Realty sitt API. Når man kaller en tjeneste vil man få 401 Unauthorized dersom man mangler et gyldig scope.
Et token har normalt gyldighet i en time. Sammen med access tokenet følger det med et refresh token som kan benyttes til å opprette et nytt access token dersom dette går ut på tid. Merk at dersom et access token blir benyttet like før det utløper kan dette medføre at kallet likevel feiler da det i noen tilfeller blir validert flere ganger i prosessen. Dette kan unngås ved at man ikke benytter et token som har mindre varighet enn en par sekunder.
Realty har en rekke scopes og de tildeles etter avtale. For detaljer se https://beta-api.ambita.com/realty/v1/scopes/
PS! Merk at alle brukere av APIet vil få tildelt egne klienter for bruk mot BETA miljø og PROD miljø. Prøver man å bruke en BETA klient i produksjon vil ikke dette virke.
Generell beskrivelse
...
Person:
Søk (/realty/v1/search/persons/):
Navn, person / organisasjon
Oppslag (/realty/v1/persons/):
Fødselsnr / organisasjonsnr / anonymPersonID
Matrikkel (offisiell id eiendom)
Organisasjonsnr og andelsnr, borettslag
Gate/vei:
Søk (/realty/v1/search/streets/):
Navn, gate / vei
Oppslag (/realty/v1/streets/):
Kommunenr og gatenr
Krets (eksempel: postnr og bydel)
Adresse:
Søk (/realty/v1/search/addresses/):
Navn gate / vei, husnr og eventuelt bokstav, eventuelt kommunenavn / poststedsnavn
Oppslag (/realty/v1/addresses/):
AdresseID (kommune, gatekode, husnr, eventuelt bokstav)
Krets (eksempel postnr og bydel)
Matrikkel (offisiell id eiendom)
Organisasjonsnr og andelsnr, borettslag
Bygningsnr
BruksenhetsID/BoligID
Eiendom:
Søk (/realty/v1/search/cadastres/):
Matrikkel (offisiell id eiendom)
Oppslag (/realty/v1/cadastres/):
AdresseID (kommune, gatekode, husnr, eventuelt bokstav)
Bygningsnr
AnonymPersonID
Posisjon (koordinat)
Driftsenhet (landbruk)
Borettslag:
Søk (/realty/v1/search/housingcooperatives/):
Navn, borettslag
Oppslag (/realty/v1/housingcooperatives/):
Organisasjonsnr, borettslag
Borettsandel:
Søk (/realty/v1/search/shares/):
Navn, borettslag og andelsnr
Oppslag (/realty/v1/shares/):
Organisasjonsnr, borettslag og andelsnr
AdresseID (kommune, gatekode, husnr, eventuelt bokstav)
AnonymPersonID
Posisjon (koordinat)
Bygning:
Søk:
Ingen
Oppslag (/searchrealty/v1/buildings/):
Bygningsnr
Matrikkel (offisiell id eiendom)
AdresseID (kommune, gatekode, husnr, eventuelt bokstav)
BruksenhetsID/BoligID
Bruksenhet/Bolig:
Søk:
Ingen
Oppslag (/realty/v1/separatelyoccupiedunits/):
BruksenhetsID/BoligID
Matrikkel (offisiell id eiendom)
AdresseID (kommune, gatekode, husnr, eventuelt bokstav)
Bygningsnr
Sted:
Søk (/realty/v1/search/places/):
Stedsnavn, eventuelt kommune
Oppslag:
Ingen
...
Viser oversikt over eiendommer og borettsandeler en person eller organisasjon eier, med informasjon om tilhørende boliger / bruksenheter, bygninger og adresser.
...
Detaljerte data om personer og organisasjoner:
Oversikt over eide objekter:
Eide eiendommer, tinglyste eierforhold cadastreOwnershipsCadastre Ownerships
Eide eiendommer, ikke tinglyste eierforhold UnregisteredOwnershipsUnregistered Ownerships
Eide borettsandeler, tinglyste eierforhold shareOwnerships
Eieranandeler / eiere owningperson
Omsetningsdokument eiendom [cadaste/Conveyances] (realty.html#Cadastre-conveyances) / eiendom [share/Conveyances] (realty.html#share-conveyances)Share Ownerships
Eieranandeler / eiere:
/realty/v1/cadastre/ownerships/{ownershipKey}/owningperson/
/realty/v1/share/ownerships/{ownershipKey}/owningperson/Omsetningsdokument:
/realty/v1/cadastres/{cadastreKey}/conveyances/
/realty/v1/shares/{shareKey}/conveyances/
Oversikt over boliger / bruksenheter, bygninger og adresser på eiendom / borettsandeler:
Boliger / bruksenheter SeparatelyOccupiedUnits
Adresse Addresses
Basistjenester
Basistjenester viser detaljert informasjon om ulike objekter. Informasjonen er hentet fra ulike offentlige registre. For en eiendom kan en for eksempel se informasjon om eiere, eiendomsgrenser og areal, adresser, boliger og bygninger, belåning, begrensninger, servitutter m.m. Tjenestene viser både aktiv og historisk informasjon.
...
Detaljerte data om eiendom:
Eiendom Cadastres
Eiendomsteiger Plots
Forretninger Affairs
Gjeldende id for historiske eiendommer ValidateCadastre
Seksjonsopplysninger Sectionings
Fornminne eiendom SingleHeritages
Grunnforurensning SoilContaminations
Eiendomsenheter RealtyEstateUnits
Klager Complaints
Driftsenhet (landbruk) operatingunits
Detaljerte data om boliger (bruksenheter) og bygninger:
Bygningsendringer BuildingChanges
Etasjer Floors
Boliger / bruksenheter SeparatelyOccupiedUnits
Kulturminner CulturalHeritages
Detaljerte data om adresser:
Adresse AddressesPresentasjonsadresse presentationAddress
Presentasjonsadresse /realty/v1/cadastres/{cadastreKey}/presentationaddress/
Kretser Districts
Gater / veier Streets
Detaljerte data om borettsandeler og borettslag:
Borettsandeler Shares
Borettslag HousingCooperatives
Detaljerte data om personer og organisasjoner:
Person Persons
Støttetjenester:
Historiske tinglysingsembeter Offices
Kommuner Municipalities
Koderegister CodeFields
Ordliste norsk / engelsk Dictionary
Stedfesting og kartvisning
Tjenester som kan benyttes for å plassere objekter (for eksempel eiendommer, bygninger / boliger og omsetninger) i kart. Kan benyttes mot Ambitas kartløsninger, men også mot andre kartløsninger som Google Maps.
...
Stedfesting:
Omsetningsdokument POC - point of conveyanceOmsetningsdokument i kart. POCs er forkortelse for Points of Conveyance og stedfester omsetningsinformasjon, se: /realty/v1/pocs/
Verdiøkte tjenester
Verdiøkte tjenester viser bearbeidet informasjon om ulike objekter. Eksempler på bearbeidet informasjon er beregnet boligverdi, pant (lån) presentert i prioritetsrekkefølge med gjeldende kreditor og beløp, m.v.
...
Verdiestimat:
Verdi eiendommer og borettsandeler cadastre/HousingValues og share/HousingValuesVerdi omliggende eiendommer og borettsandeler cadastre/SurrondingHousingvalue og share/SurrondingHousingvalueeiendommer og borettsandeler
/realty/v1/cadastres/{cadastreKey}/housingvalue/
/realty/v1/shares/{shareKey}/housingvalue/Verdi omliggende eiendommer
/realty/v1/cadastres/{cadastreKey}/surroundinghousingvalues/
Bearbeidet presentasjon av pant:
Bearbeidet presentasjon av pant cadastre/LiensCalculations og share/LiensCalculations
/realty/v1/cadastres/{cadastreKey}/lienscalculation/
/realty/v1/shares/{shareKey}/lienscalculation/