Spring til indhold

Grundfast

DatafordelerenMatriklen2 REST

Matriklen REST efter 15. januar 2027: samme sti, ny vært

Datafordelerens Matriklen2 REST-tjeneste lukker den 15. januar 2027. Grundfast svarer på de samme stier i begge versioner, med de samme parametre og den samme JSON eller XML, hentet 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/Matriklen2/Matrikel/2.0.0/rest/SamletFastEjendom?Format=JSON&SFEBFEnr=5651067&username=TJENESTEBRUGER&password=…'

# Efter — samme sti, samme parametre, samme JSON. Kun værten og nøglen skifter.
curl 'https://api.grundfast.dk/datafordeler/Matriklen2/Matrikel/2.0.0/rest/SamletFastEjendom?Format=JSON&SFEBFEnr=5651067&password=gf_live_…'

Metoderne

Seks metoder i version 2.0.0 og de samme under /Matriklen2/Matrikel/1.0.0/rest/, hvor MatrikulaerSag som før er uden listen over sagsoperationer. Parameternavne matches uden hensyn til store og små bogstaver, som i REST; værdierne ikke, bortset fra Ejendomstype og Kommunenavn.

  • /datafordeler/Matriklen2/Matrikel/2.0.0/rest/SamletFastEjendom
  • /datafordeler/Matriklen2/Matrikel/2.0.0/rest/BygningPaaFremmedGrund
  • /datafordeler/Matriklen2/Matrikel/2.0.0/rest/Ejerlejlighed
  • /datafordeler/Matriklen2/Matrikel/2.0.0/rest/BestemtFastEjendom
  • /datafordeler/Matriklen2/Matrikel/2.0.0/rest/MatrikelKommune
  • /datafordeler/Matriklen2/Matrikel/2.0.0/rest/MatrikulaerSag

Parametre pr. metode

SamletFastEjendom

SFEBFEnr · Ejerlavskode + Matrikelnr · Point · JordstykkeId · SagsId

Registreringstid · Virkningstid · Status

BygningPaaFremmedGrund

SFEBFEnr · BPFGBFEnr · Ejerlavskode + Matrikelnr · Point · SagsId

Registreringstid · Virkningstid · Status

Ejerlejlighed

SFEBFEnr · BPFGBFEnr · ELBFEnr · Ejerlavskode + Matrikelnr (+ Ejerlejlighednr) · SagsId

Registreringstid · Virkningstid · Status

BestemtFastEjendom

BFEnr (flere med |) · SagsId · Ejendomstype

Registreringstid · Virkningstid · Status

MatrikelKommune

Kommunekode · Kommunenavn

Registreringstid · Virkningstid · Status · RegistreringstidFra/Til · VirkningstidFra/Til

MatrikulaerSag

SagsId · Journalnr · Sagskategori · Kommunenavn

Registreringstid · Virkningstid · Status · RegistreringstidFra/Til · VirkningstidFra/Til

Som i REST tager kun BFEnr på BestemtFastEjendom flere værdier (adskilt med |). Der er ingen sider: page, pagesize og count giver REST’s egen 400, og hele svaret er én FeatureCollection. Format=XML giver XML, alt andet JSON. Uden et identificerende parameter er svaret tomt — aldrig hele registret.

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. En nøgle med begrænset adgang skal have Matriklen med.

# Nøglen kan også sendes som header, og version 1.0.0 svarer også
curl -H 'Authorization: Bearer gf_live_…' \
  'https://api.grundfast.dk/datafordeler/Matriklen2/Matrikel/1.0.0/rest/BestemtFastEjendom?BFEnr=5651067|426091'

Hvor tæt på REST?

Svarene er sammenlignet med den levende REST-tjeneste, hentet samme øjeblik fra REST og GraphQL: 68 optagne sager på tværs af alle seks metoder og begge versioner, med XML-svar, fejlsvar og tomme svar. I hver sag var hvert objekt identisk, med samme feltrækkefølge, når listernes rækkefølge ses bort fra. Dertil 90 af 90 tilfældige stikprøver og det bredeste opslag, REST tillod — 1 075 af 1 075 sager identiske. Herunder står alle kendte forskelle. Finder I en, 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.

  • Et interval med flere versioner af samme sag besvares

    MatrikulaerSag

    Ramte RegistreringstidFra/Til (eller VirkningstidFra/Til) flere versioner af samme sag, svarede REST "(500) Internal server error". Her returneres versionerne.

    Kilde: Live-prøve 2026-10-27: SagsId=100240508&RegistreringstidFra=2026-01-01&RegistreringstidTil=2026-10-01.

  • Interval på begge tidsakser: navn og journalnummer slås op i dag

    MatrikelKommuneMatrikulaerSag

    Med interval på både registrering og virkning findes objekterne via deres id: Kommunekode og SagsId direkte, men Kommunenavn, Journalnr og Sagskategori slås op på det angivne (eller nuværende) tidspunkt først. En kommune eller sag der ikke findes på det tidspunkt, findes derfor kun via sin kode eller sit id.

    Gør sådan: Brug Kommunekode eller SagsId sammen med to intervaller.

    Kilde: Følger af MAT/v3: uden tidspunkt-argumenter skal der filtreres på id_lokalId.

Parametre

Parametre, REST tog imod, men som her afvises med 400 og parameterens navn — aldrig stiltiende ignoreret.

  • Sagsoperation og RekvirentRef afvises med 400

    MatrikulaerSag

    REST genkendte de to parametre, men matchede dem ikke forudsigeligt: RekvirentRef=20265088 gav intet svar, selvom sag 100240508 har netop den rekvirentRef. I stedet for at gætte REST’s regel afvises de med en 400, der navngiver parameteren.

    Gør sådan: Slå sagen op med SagsId eller Journalnr.

    Kilde: Live-prøve 2026-10-27 (SagsId=100240508 → rekvirentRef 20265088; RekvirentRef=20265088 → 0 sager).

Sider og grænser

Sidestørrelse, rækkefølge og de lofter, GraphQL-kilden sætter.

  • Rækkefølgen i lister er fast her, tilfældig i REST

    REST svarede objekter og indlejrede lister (jordstykker, centroider, ejerlejligheder, bygninger på fremmed grund, sagsoperationer, bestemtFastEjendom) i en rækkefølge der kunne skifte mellem to ens kald. Her sorteres efter id_lokalId, så registreringFra, så status. Indholdet er det samme, dubletter i sagsoperationer bevares.

    Gør sådan: Sortér selv, hvis rækkefølgen betyder noget.

    Kilde: Paritetsfixtures: alle 68 sager er identiske som multimængder; rækkefølgen afveg i flere.

  • Højst 5 000 objekter i ét svar

    REST havde ingen paging og ingen øvre grænse. Her afvises et kald, der rammer mere end 5 000 objekter på øverste niveau, med en 400. Det bredeste opslag REST tillod i prøverne (en sagskategori i en kommune) gav 1 075 sager og besvares fuldt.

    Gør sådan: Del opslaget op (fx per kommune eller sag).

    Kilde: Live-prøve 2026-10-27: Sagskategori=Matrikulær sag&Kommunenavn=Billund Kommune, 1 075/1 075 identiske.

Nøgle, format og fejl

Det, der ligger uden om selve dataene.

  • Forslaget i "Did you mean" kan være et andet

    Et ukendt parameternavn giver samme 400-tekst som REST ("(400) Parameter: x unrecognized."), men det foreslåede navn vælges efter redigeringsafstand og er ikke altid det REST foreslog (REST foreslog fx "page" for "kommunekode").

    Kilde: Live-prøve 2026-10-27.

  • Et ugyldigt Point giver 400, ikke 500

    SamletFastEjendomBygningPaaFremmedGrund

    Point skal være WKT: POINT(x y) i EPSG:25832, mellemrummet URL-kodet. REST svarede en anden form (fx "x y") med "(500) Internal server error"; her er det en 400 med eksempel på formen.

    Kilde: Live-prøve 2026-10-27.

  • Nedbrud hos Datafordeleren er JSON

    Parameterfejl er REST’s egne tekstsvar (text/plain). Svarer Datafordelerens GraphQL ikke, gives 502/503 med JSON {"error": …} som i resten af API’et, hvor REST gav en tekst.

    Kilde: Controllerens fejlgren.

Vil I hellere have ejendommens jordstykker samlet på BFE med geometri i WGS84, er /v1/matrikel Grundfasts egen form. Begge kan bruges med den samme nøgle.

Ofte stillede spørgsmål

Kun værten og nøglen. https://services.datafordeler.dk/Matriklen2/Matrikel/2.0.0/rest/… bliver til https://api.grundfast.dk/datafordeler/Matriklen2/Matrikel/2.0.0/rest/…, og password= får en Grundfast-nøgle i stedet for tjenestebrugerens adgangskode (username ignoreres). Stier, parametre, FeatureCollection, feltnavne og XML er de samme; de kendte afvigelser står på siden.

Version 1.0.0 og 2.0.0, begge med SamletFastEjendom, BygningPaaFremmedGrund, Ejerlejlighed, BestemtFastEjendom, MatrikelKommune, MatrikulaerSag. Som i den gamle tjeneste har MatrikulaerSag kun listen over sagsoperationer i version 2.0.0.

Stien er med på alle planer, også den gratis. Et kald er én enhed i den almindelige kvote, uanset hvor mange objekter svaret har — der er ingen særskilt pris pr. register.

Ja, inden for de kendte afvigelser. I 68 optagne sager på tværs af alle metoder og begge versioner var hvert objekt identisk med REST-svaret, når listernes rækkefølge ses bort fra — også i XML. 90 tilfældige stikprøver mod den levende tjeneste og det bredeste opslag, den tillod (1 075 sager), var også identiske.

Fra Datafordelerens moderniserede GraphQL-tjeneste for Matriklen, 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 Matriklen-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