Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
| Anchor | ||||
|---|---|---|---|---|
|
Siden beskriver de webservices der udstilles på Datafordeleren fra Ejendomsbeliggenhedsregistret (EBR).
Få en introduktion til Webservice på Datafordeleren (REST), hvis du har brug for en introduktion til og vejledning i, hvordan man kan anvende webservices, som udstilles på Datafordeleren.
Få en guide til helt konkrete anvisninger til at bruge en webservice fra Datafordeleren i Guide til webservice på Selvbetjeningen (REST).
| Table of Contents |
|---|
Url opbygning for REST
Url for de enkelte services er opbygget af et endpoint efterfulgt af registernavn, servicenavn, versionen af servicen, servicetype (REST eller WFS etc.) samt metodenavn for REST services. Efter ? tilføjes parametre i kaldet, der kan indeholde generelle kaldeparametre for REST services og metode specifikke parametre.
Endpointet indeholder værtsnavnet, med et præfiks for miljøet hvis det ikke er produktionsmiljøet der tilgås. Hvis der er tale om fortrolige eller følsomme data, følger S5 og at servicen skal kaldes med certifikat derfor certservices - se miljøbeskrivelser.
| Url-struktur for REST services | <endpoint>/register/service/version/servicetype/metode? |
|---|---|
| Eksempel | https://services.datafordeler.dk/EBR/Ejendomsbeliggenhed/1/REST/Ejendomsbeliggenhed? |
Generelt for EBR
)webservices
I nedenstående afsnit beskrives de tjenester på Datafordeleren der udstiller Ejendomsbeliggenhed. Ejendomsbeliggenhed er i hovedreglen en reference mellem ejendommen og den adresse der skal anvendes som beliggenhedsadresse. I tilfælde hvor der ikke eksisterer en adresse for en ejendom er der i Ejendomsbeliggenhed en beliggenhedsbetegnelse til anvendelse i stedet for en faktisk adresse. Beliggenhedsbetegnelsen er en tekst dannet på baggrund af bl.a. informationer i Danmarks Administrative og Geografiske Inddelinger. I Ejendomsbeliggenhed er der desuden information om hvilken kommune der har det administrative ansvar for informationen i Ejendomsbeliggenhed.
REST - Ejendomsbeliggenhed
| Format | XML/JSON |
|---|---|
| DLS version | 2.7 |
| Sikkerhedszone | 0 – Indeholder ikke fortrolige eller følsomme data |
| Adgangsniveau | Alle kendte brugere må tilgå tjenesten |
| Adgangsbegrænsning | Ingen adgangsbegrænsning |
| Anvendt udstillingsmodel | Ejendomsbeliggenhed, Matrikel, DanmarksAdresseRegister, DAGI |
| REST-regler | Anvend paging. Default paging-størrelse: 20 |
| SLA | Se registrets tilgængelighed på Datafordeler.dk |
| Dato- og tidsformat | Datoformat følger ISO 8601 Date and time format. Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS.ssssss, hvor tidsangivelsen kan udelades. UTC kan angives enten ved +HH:MM (2019-07-05T07:50:14.687580+01:00) eller ved at benytte Z (2019-07-05T07:50:14.687580Z) |
REST - Ejendomsbeliggenhed
Metodeoversigt
Metodenavn | SLA kategori | Tværgående tjeneste |
|---|---|---|
BFEnrAdresse | Kompleks | Ja |
Ejendomsbeliggenhed | Kompleks | Ja |
EjendomsbeliggenhedSimpel | Kompleks | Nej |
SLA kategorier i produktion- maksimal svartid i sekunder:
- Simpel: 0.09
- Normal: 1.0
- Kompleks: 2.5
Metode - BFEnrAdresse
Beskrivelse
Henter Ejendomsbeliggenhed (herunder BFEnr) for en eller flere DAR adresser, som er registreret i Ejendomsbeliggenhedsregisteret (objekttype Ejendomsbeliggenhed).
Url
https://<endpoint>.datafordeler.dk/EBR /Ejendomsbeliggenhed/1/rest/BFEnrAdresse? |
Inputparametre
Følgende parameter er obligatorisk: AdresseId (som enkelt eller liste) ELLER HusnummerId (som enkelt eller liste) Øvrige parametre er valgfri.
Datoformat følger ISO 8601 Date and time format.
Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS - eksempelvis 2018-06-26T17:23:00
| Navn | Type | Beskrivelse | Default værdi |
|---|---|---|---|
AdresseId | String (List) | Liste af lokalId UUID for DAR Adresse | NULL |
HusnummerId | String (List) | Liste af lokalId UUID for DAR Husnummer | NULL |
Registreringstid | DateTime | Dato som falder indenfor en registreringstidsperiode. Anvendes fx 2015-09-02 vil de instanser med en gældende registreringstid på denne dato udvælges | NOW() |
Virkningstid | DateTime | Dato som falder indenfor en virkningstidsperiode. Anvendes fx 2015-09-02 vil de instanser med en gældende virkningstid på denne dato udvælges | NOW() |
Status | String | Status jf. modellens udfaldsrum | NULL |
Outputparametre
Metode | Skema |
|---|---|
Den inkluderede fil ” EBR_v2.8_BFEnrAdresse.json” indeholder output som JSON-schema | EBR_v2.8_BFEnrAdresse.json |
Metode - Ejendomsbeliggenhed
Beskrivelse
Henter Ejendomsbeliggenhed (herunder beliggenhedsadressen samt oplysning om administrativ ansvarlig kommune) tilknyttet en Bestemt Fast Ejendom.
Genereres på baggrund af Ejendomsbeliggenhedsregisteret på Datafordeleren.
Url
| https://<endpoint>.datafordeler.dk/EBR/Ejendomsbeliggenhed/1/rest/Ejendomsbeliggenhed? |
Inputparametre
Følgende parametre er obligatoriske: EBId (som enkelt eller liste) ELLER BFEnr (som enkelt eller liste). Øvrige parametre er valgfri.
Listen må maksimalt indeholde 200 BFEnumre.
Datoformat følger ISO 8601 Date and time format.
Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS - eksempelvis 2018-06-26T17:23:00
| Navn | Type | Beskrivelse | Default værdi |
|---|---|---|---|
EBId | String (List) | Liste af Id for ejendomsbeliggenhed | NULL |
BFEnr | Integer (List) | Liste af Bestemt Fast Ejendom numre | NULL |
Registreringstid | DateTime | Dato som falder indenfor en registreringstidsperiode. Anvendes fx 2015-09-02 vil de instanser med en gældende registreringstid på denne dato udvælges | NOW() |
Virkningstid | DateTime | Dato som falder indenfor en virkningstidsperiode. Anvendes fx 2015-09-02 vil de instanser med en gældende virkningstid på denne dato udvælges | NOW() |
Status | String | Status jf. modellens udfaldsrum | NULL |
Outputparametre
Metode | Skema |
|---|---|
Den inkluderede fil ”EBR_v2.8_Ejendomsbeliggenhed.json” indeholder output som JSON-schema | EBR_v2.8_Ejendomsbeliggenhed.json |
Metode - EjendomsbeliggenhedSimpel
Beskrivelse
Henter Beliggenhedsadressen tilknyttet en Bestemt Fast Ejendom performanceeffektivt, dvs. uden joins til andre registre.
Url
| https://<endpoint>.datafordeler.dk/EBR/Ejendomsbeliggenhed/1/rest/EjendomsbeliggenhedSimpel? |
Inputparametre
Følgende parametre er obligatoriske: EBId (som enkelt eller liste) ELLER BFEnr (som enkelt eller liste). Øvrige parametre er valgfri.
Listen må maksimalt indeholde 200 BFEnumre.
Datoformat følger ISO 8601 Date and time format.
Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS - eksempelvis 2018-06-26T17:23:00
| Navn | Type | Beskrivelse | Default værdi |
|---|---|---|---|
EBId | String (List) | Liste af Id for ejendomsbeliggenhed | NULL |
BFEnr | Integer (List) | Liste af Bestemt Fast Ejendom numre | NULL |
RegistreringstidFra | DateTime | Dato som angiver starten af en periodesøgning på registreringstid. Medtager alle elementer der er afregistreret efter dette tidspunkt. | NULL |
RegistreringstidTil | DateTime | Dato som angiver slutningen af en periodesøgning på registreringstid. Medtager alle elementer der er registreret før dette tidspunkt. | NULL |
VirkningstidFra | DateTime | Dato som angiver starten af en periodesøgning på virkningsstid. Medtager alle elementer hvis effekt ophørte efter dette tidspunkt. | NULL |
VirkningstidTil | DateTime | Dato som angiver slutningen af en periodesøgning på virkningsstid. Medtager alle elementer der kom i effekt efter eller på dette tidspunkt. | NULL |
Registreringstid | DateTime | Dato som falder indenfor en registreringstidsperiode. Anvendes fx 2015-09-02 vil de instanser med en gældende registreringstid på denne dato udvælges | NOW() |
Virkningstid | DateTime | Dato som falder indenfor en virkningstidsperiode. Anvendes fx 2015-09-02 vil de instanser med en gældende virkningstid på denne dato udvælges | NOW() |
Status | String | Status jf. modellens udfaldsrum | NULL |
Outputparametre
Metode | Skema |
|---|---|
Den inkluderede fil ”EBR_v2.8_EjendomsbeliggenhedSimpel.json” indeholder output som JSON-schema | EBR_v2.8_EjendomsbeliggenhedSimpel.json Skema - filudtræk og webservices (EBR) |