DatafordelerenEjendomsbeliggenhed REST # EBR REST efter 15. januar 2027: samme sti, ny vært Datafordelerens REST-tjeneste for Ejendomsbeliggenhedsregistret lukker den **15. januar 2027**. Grundfast svarer på de samme stier med de samme parametre og den samme JSON eller XML, samlet fra Datafordelerens GraphQL. Integrationen skifter kun vært og nøgle. [Datafordelerens REST lukker om 80 dage · 15. januar 2027](https://grundfast.dk/datafordeler-rest-lukker) ## Før og efter Erstat `https://services.datafordeler.dk` med `https://api.grundfast.dk/datafordeler`, og læg en Grundfast-nøgle i `password=`. ``` # Før — lukker 15. januar 2027 curl 'https://services.datafordeler.dk/EBR/Ejendomsbeliggenhed/1/rest/EjendomsbeliggenhedSimpel?Format=JSON&BFEnr=5651067&username=TJENESTEBRUGER&password=…' # Efter — samme sti, samme parametre, samme JSON. Kun værten og nøglen skifter. curl 'https://api.grundfast.dk/datafordeler/EBR/Ejendomsbeliggenhed/1/rest/EjendomsbeliggenhedSimpel?Format=JSON&BFEnr=5651067&password=gf_live_…' ``` ## Metoderne Tre metoder fra Ejendomsbeliggenhed version 1. Parameternavne matches uden hensyn til store og små bogstaver, som i REST. - `/datafordeler/EBR/Ejendomsbeliggenhed/1/rest/BFEnrAdresse` - `/datafordeler/EBR/Ejendomsbeliggenhed/1/rest/Ejendomsbeliggenhed` - `/datafordeler/EBR/Ejendomsbeliggenhed/1/rest/EjendomsbeliggenhedSimpel` ### Parametre pr. metode BFEnrAdresse AdresseId · HusnummerId Registreringstid · Virkningstid · Status Ejendomsbeliggenhed BFEnr · EBId Registreringstid · Virkningstid · Status EjendomsbeliggenhedSimpel BFEnr · EBId Registreringstid · Virkningstid · Status · RegistreringstidFra/Til · VirkningstidFra/Til Alle tre metoder tager desuden `count`, `page` (fra 1), `pagesize` (som standard 20) og `Format`. Flere værdier i BFEnr, EBId, AdresseId og HusnummerId adskilles med `|`; `Status` er én værdi, fx `gældende`. Som i REST kan `count` ikke kombineres med sider, og uden et identificerende parameter er svaret en tom FeatureCollection. ## Nøglen - `password=` i URL’en — det sted, hvor tjenestebrugerens adgangskode stod. `username=` ignoreres og kan blive stående. - `apiKey=` eller `token=` i URL’en. - Headeren `Authorization: Bearer …` eller `X-API-Key`. Nøglen skrives aldrig i Grundfasts logs. Stien er med på alle planer, også den gratis, og et kald er én enhed i den almindelige kvote uanset sidestørrelse. En nøgle med begrænset adgang skal have Matriklen med. ``` # Nøglen kan også sendes som header i stedet for i URL'en curl -H 'Authorization: Bearer gf_live_…' \ 'https://api.grundfast.dk/datafordeler/EBR/Ejendomsbeliggenhed/1/rest/BFEnrAdresse?HusnummerId=' ``` ## Hvor tæt på REST? Svarene er sammenlignet felt for felt med den levende REST-tjeneste i 20 optagne sager fra alle tre metoder, hentet samme øjeblik fra REST og GraphQL: ét og flere BFE-numre, EBId, AdresseId, HusnummerId, perioder, historiske tidspunkter, Status, tællinger og XML. Af 1 303 sammenlignede værdier afveg 60, og de står alle herunder. Finder I en forskel, der ikke står her, er det en fejl — skriv til [hej@grundfast.dk](mailto:hej@grundfast.dk?subject=EBR%20REST-afvigelse). ### Data Værdier eller former i svaret, der ikke er som i REST. - #### `datafordelerOpdateringstid` i de indlejrede DAR-objekter er GraphQL-kildens egen Ejendomsbeliggenhed I det fulde Ejendomsbeliggenhed-svar har husnummer, adresse, navngiven vej, vejkommunedel, adgangs- og vejpunkt, postnummer og supplerende bynavn feltet `datafordelerOpdateringstid`. Det angiver hvornår rækken blev indlæst i Datafordelerens GraphQL-lager og er derfor en anden værdi end REST svarede — fra en brøkdel af et sekund til et par timer. Selve ejendomsbeliggenheden har ikke feltet. Alle andre felter havde identiske værdier i paritetsprøverne. Gør sådan: Brug ikke feltet som synkroniseringsmarkør mod gemte REST-svar. Kilde: Paritetsfixtures: alle afvigende værdier i de fulde svar var dette felt eller menighedsrådsafstemningsområdet. - #### Menighedsrådsafstemningsområde har kun sit id Ejendomsbeliggenhed REST skrev `menighedsrådsafstemningsområde` som `{id_lokalid, mrafstemningsområdenummer, navn}`. DAR oplyser stadig områdets id, men ingen af Datafordelerens moderne tjenester (GraphQL eller WFS) udstiller områdets nummer og navn. Objektet har derfor kun `id_lokalid` — samme værdi som REST. De øvrige DAGI-områder (afstemningsområde, kommuneinddeling, sogneinddeling) er komplette. Gør sådan: Slå nummer og navn op i jeres egen kopi af DAGI, hvis I bruger dem. Kilde: DAGI/v2 GraphQL og DAGI-WFS (GetCapabilities) 2026-10-27: ingen menighedsråd-entitet. - #### Perioder på begge tidsakser uden EBId EjendomsbeliggenhedSimpel Med både RegistreringstidFra/Til og VirkningstidFra/Til og uden EBId findes ejendomsbeliggenhederne først som de var registreret ved periodens slutning, og derefter hentes alle deres versioner. En ejendomsbeliggenhed der både blev oprettet og slettet inden for registreringsperioden findes derfor ikke. Med EBId, eller med et tidspunkt på den ene akse, er svaret fuldstændigt. Kilde: GraphQL kræver et id-filter for at give alle versioner (DAF-GQL-0009); paritetsfixture simpel-periods-bfe. - #### Felter der ikke forekom i paritetsprøverne Ejendomsbeliggenhed BFEnrAdresse En adresses `bygning` og `dørpunkt`, en navngiven vejs `beskrivelse`, `vejnavnebeliggenhed_vejnavneområde` og `vejnavnebeliggenhed_vejtilslutningspunkter`, og `Ejendomstype` for et BFE-nummer Matriklen ikke kender på tidspunktet, forekom ikke i de optagne svar. De skrives efter samme regler som de afprøvede felter (id som tekst, geometri som WKT, ukendt Ejendomstype som null), men er ikke sammenlignet med REST. Kilde: Paritetsfixtures 2026-10-27. ### Parametre Parametre, REST tog imod, men som her afvises med 400 og parameterens navn — aldrig stiltiende ignoreret. - #### Navneforslaget i fejlen for en ukendt parameter En ukendt parameter giver REST’s fejl `(400) Parameter: x unrecognized.`. REST tilføjede somme tider et forslag ("Did you mean: …?") efter en regel vi ikke kunne aflede; her gives forslaget kun når en gyldig parameter staves næsten ens. Kilde: Live-prøver 2026-10-27. ### Sider og grænser Sidestørrelse, rækkefølge og de lofter, GraphQL-kilden sætter. - #### Rækkefølgen af flere ejendomsbeliggenheder i EjendomsbeliggenhedSimpel EjendomsbeliggenhedSimpel Svarer EjendomsbeliggenhedSimpel med flere forskellige ejendomsbeliggenheder (fx flere BFE-numre), kom de fra REST i en rækkefølge der hverken fulgte BFE-nummer, id eller registreringstid. Her sorteres efter `id_lokalId` — som REST selv gjorde i BFEnrAdresse og Ejendomsbeliggenhed. Indholdet er det samme, men ved sideinddeling kan en række lande på en anden side. Flere versioner af samme ejendomsbeliggenhed (perioder) kommer i REST’s rækkefølge: nyeste registrering først. Gør sådan: Sortér selv, eller hent alt på én side (pagesize), hvis rækkefølgen betyder noget. Kilde: Paritetsfixtures simpel-bfe-multi, simpel-bfe-multi-page2, simpel-ebid-multi. - #### Højst 1000 værdier pr. parameter og 20 000 rækker pr. kald Et kald med flere end 1000 værdier i én parameter (BFEnr, EBId, AdresseId, HusnummerId), eller et filter der rammer flere end 20 000 versioner, afvises med HTTP 400. REST angav ingen grænse. Gør sådan: Del store lister op i flere kald. Kilde: Grænse sat i datafordeler-compat/ebr/params.ts og services/datafordeler-ebr-rest.service.ts. ### Nøgle, format og fejl Det, der ligger uden om selve dataene. - #### count=true med BFEnr giver et antal Ejendomsbeliggenhed REST svarede HTTP 500 på Ejendomsbeliggenhed?BFEnr=…&count=true. Her gives antallet, som ved EBId. Kilde: Live-prøve 2026-10-27. - #### Ugyldige kald REST besvarede med HTTP 500 Enkelte ugyldige kald gav HTTP 500 i REST (fx BFEnrAdresse?page=x uden andre filtre, EjendomsbeliggenhedSimpel?HusnummerId=x). Her er de HTTP 400 med REST’s fejltekst for samme fejl. Kilde: Live-prøver 2026-10-27. - #### Når Datafordelerens GraphQL ikke svarer Svarer Datafordelerens GraphQL ikke, gives HTTP 502 eller 503 med en fejltekst. Der er ingen lokal kopi af EBR at svare fra. Kilde: services/datafordeler-ebr-rest.service.ts. Vil I hellere slå adresse og ejendom op i Grundfasts egen form, med BFE-nummer på adressen og WGS84, findes det under [/v1](https://grundfast.dk/docs/api). Begge kan bruges med den samme nøgle. ## Ofte stillede spørgsmål ### Skal jeg ændre min kode for at bruge Grundfasts EBR REST-sti? Kun værten og nøglen. https://services.datafordeler.dk/EBR/Ejendomsbeliggenhed/1/rest/… bliver til https://api.grundfast.dk/datafordeler/EBR/Ejendomsbeliggenhed/1/rest/…, og password= får en Grundfast-nøgle i stedet for tjenestebrugerens adgangskode (username ignoreres). Stier, parametre, FeatureCollection og XML er de samme; de kendte afvigelser står på siden. ### Hvilke metoder findes? BFEnrAdresse, Ejendomsbeliggenhed, EjendomsbeliggenhedSimpel — de tre metoder fra Ejendomsbeliggenhed version 1, hver med de parametre den gamle tjeneste tog imod. BFEnrAdresse slår op på AdresseId og HusnummerId, ikke på BFEnr. ### Hvad koster det? Stien er med på alle planer, også den gratis. Et kald er én enhed i den almindelige kvote, uanset sidestørrelse — der er ingen særskilt pris pr. register. ### Er svaret det samme som fra Datafordelerens REST-tjeneste? Ja, inden for de kendte afvigelser. I 20 optagne sager mod den levende REST-tjeneste blev 1 303 værdier sammenlignet; de 60, der afveg, er alle beskrevet på siden: datafordelerOpdateringstid i de indlejrede DAR-objekter, menighedsrådsafstemningsområdets nummer og navn, og rækkefølgen i EjendomsbeliggenhedSimpel med flere ejendomsbeliggenheder. ### Hvor kommer dataene fra? Fra Datafordelerens moderniserede GraphQL-tjenester for EBR, Matriklen, DAR og DAGI, hentet live ved hvert kald og skrevet om til REST-formen. Grundfast er ikke tilknyttet Klimadatastyrelsen. ## Skift værten før 15. januar Opret en gratis nøgle, sæt den i `password=`, og kør jeres eksisterende EBR-kald mod `api.grundfast.dk/datafordeler`. [Kom i gang gratis](https://grundfast.dk/dashboard?mode=register) [Hvad der ellers lukker](https://grundfast.dk/datafordeler-rest-lukker) Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0 Se også - [Datafordeler-REST lukker Hvad der lukker 15. januar 2027](https://grundfast.dk/datafordeler-rest-lukker) - [Matriklen REST på samme sti Matriklen2 — skift kun værten](https://grundfast.dk/datafordeler-matriklen-rest) - [BBR REST på samme sti BBRPublic — skift kun værten](https://grundfast.dk/datafordeler-bbr-rest) - [Migreringsguide 2026 Tidslinje og trin for trin](https://grundfast.dk/migrering) Begreber og guides - [Datafordeler](https://grundfast.dk/begreber/datafordeler) - [BFE-nummer](https://grundfast.dk/begreber/bfe-nummer) - [DAR](https://grundfast.dk/begreber/dar) - [Hvordan klarer vi os med færre kald?](https://grundfast.dk/guides/spar-paa-kald)