Spring til indhold

Grundfast

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

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=<husnummerets id_lokalId>'

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.

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

    EjendomsbeliggenhedBFEnrAdresse

    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. Begge kan bruges med den samme nøgle.

Ofte stillede spørgsmål

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.

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.

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.

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.

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 gratisHvad der ellers lukker

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0

Se også

Begreber og guides