- Created by Maria Klostermann Tapdrup, last modified by Ida-Marie Helene Pejtersen on Jan 19, 2026
Vær opmærksom på at REST bliver udfaset på Datafordeleren den 30. juni 2026. Gå i stedet til GraphQL. Læs mere om transitionen til GraphQL på følgende sider:
Siden beskriver de REST tjenester, der udstilles på Datafordeleren fra Danmarks Administrative Geografiske Inddeling (DAGI)
Dokumentation for REST for er samlet på denne side. Dokumentation for WFS er formidlet i Dataoversigt på datafordeler.dk
Få en introduktion til REST på Datafordeleren (udfases Q2-2026), 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 REST på Selvbetjeningen (udfases Q2-2026).
Sideinformation
| Oprindelig kilde | Datafordeleren |
|---|---|
| Forfatter | Datafordeleren |
| Oprettet | Jul 02, 2019 |
| Version | 1.0 |
| Ændret | Jan 19, 2026 |
| Sidehistorik |
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 services. Efter ”?” tilføjes parametre i kaldet, der kan indeholde generelle kaldeparametre for REST services og metodespecifikke 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 - se miljøbeskrivelser.
Læs mere om sammensætning af url'er på siden REST på Datafordeleren (udfases Q2-2026) eller se eksempler på, at parametre bliver tilføjet til url'er på Datafordeleren - eksempler på anvendelse af bitemporalitet eller User stories (REST) (udfases Q2-2026).
| Url-struktur for REST services | <endpoint>/register/service/version/servicetype/metode? |
|---|---|
| Eksempel på url med brugernavn/adgangskode | https://services.datafordeler.dk/DAGIM/DAGI/1/rest/DAGI?x=xxxxxx&y=yyyyyy&username=xxx&password=yyy |
| Eksempel på url med certifikat | https://certservices.datafordeler.dk//DAGIM/DAGI/1/rest/DAGI?x=xxxxxx&y=yyyyyy |
Generelt for DAGI webservices
| Registernavn i Selvbetjeningen | DAGIM |
|---|---|
| Format | XML/JSON |
| DLS version | 1.29 |
| Sikkerhedszone | 0 – Indeholder ikke fortrolige eller følsomme data |
| Adgangsniveau | Kendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode |
| Adgangsbegrænsning | Ingen adgangsbegrænsning |
| Paging | Anvender paging. Default paging-størrelse: 20 |
| 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. Tidszonen kan angives enten ved (2019-02-05T07:50:14.687580+01:00 (for normaltid/vintertid)), (2019-07-05T07:50:14.687580+02:00 (for sommertid)) eller ved at benytte Z (2019-07-05T07:50:14.687580Z). |
REST - DAGI
| Anvendt udstillingsmodel | DAGImulti |
|---|---|
| SLA | Se registrets tilgængelighed på datafordeler.dk |
Metodeoversigt
Metodenavn | SLA kategorier | Tværgående tjeneste |
|---|---|---|
DAGI | Kompleks | Nej |
SLA kategorier i produktion- maksimal svartid i sekunder:
- Simpel: 0.09
- Normal: 1.0
- Kompleks: 2.5
Metode - DAGI
Beskrivelse
Servicen skal finde de nærmeste DAGI temaer for et givet punkt. På land vil det være de DAGI temaer punktet ligger i (svarende til WITHIN). På vand vil det være de nærmeste DAGI temaer i en lige linje ind til land (dog ikke Supplerende Bynavn, der kun søger WITHIN). Der skal søges i multigeometrier (DAGI_multi) og i referenceskala. Der skal kun søges blandt gældende objekter (ikke historiske og ikke fremtidige).
Eksempel på url med brugernavn/adgangskode
| https://services.datafordeler.dk/DAGIM/DAGI/1/rest/DAGI?x=xxxxxx&y=yyyyyy&username=xxx&password=yyy |
Eksempel på url med certifikat
| https://certservices.datafordeler.dk//DAGIM/DAGI/1/rest/DAGI?x=xxxxxx&y=yyyyyy |
Inputparametre
| Navn | Type | Beskrivelse | Tekstversion | UUID fra udstillingsmodel |
|---|---|---|---|---|
| point | String | UTM32 etrs89 geometripunkt defineret som indholdet i parentes fx point=(724786 6176332) | Kommuneinddeling.geometri | EAID_25AE826A_41DD_40a6_9AF4_3D347B1DA89F |
Outputparametre
| Metode | Skema |
|---|---|
| Den inkluderede fil ”DAGI_1.28_dagi.json” indeholder output som JSON-schema |