List områder i et tema
Alle områder i én administrativ inddeling som kode og navn, fx de 99 kommuner.
https://api.grundfast.dk/v1/dagi/{tema}Svaret er en ren kodeliste — kode og navn for hvert område — uden geometri. Den kommer fra det medfølgende register, så kaldet afhænger ikke af Datafordeler og svarer også, når kilden er nede.
Koderne er DAGI’s egne, nulpolstrede strenge (0751 for Aarhus Kommune, 1084 for Region Hovedstaden). Brug dem direkte i /v1/dagi/:tema/:kode.
Godkendelse · API-nøgle
Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.
Afregning
Ét kald.
Eksempel
curl "https://api.grundfast.dk/v1/dagi/kommune" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"tema": "kommune",
"antal": 99,
"omraader": [
{
"kode": "0101",
"navn": "København"
},
{
"kode": "0147",
"navn": "Frederiksberg"
},
{
"kode": "0151",
"navn": "Ballerup"
},
{
"kode": "0153",
"navn": "Brøndby"
}
],
"meta": {
"kilde": "Datafordeler DAGI via Grundfast",
"grundfast_version": "0.1.0"
}
}Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.
Parametre
temastringstipåkrævet- Den administrative inddeling, der skal listes.Værdier:regionkommunesognretskredspolitikredsopstillingskredsEksempel:
kommune
Felter i svaret
temastring- Det tema, der blev spurgt om.
antalinteger- Antal områder i listen.
omraader[].kodestring- Områdets DAGI-kode som streng, fx
0751. Behandl den som tekst — foranstillede nuller betyder noget. omraader[].navnstring- Områdets navn, fx "Aarhus".
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | tema er ikke et af de seks kendte temaer. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se Retry-After. |
Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.
{
"error": "property not found",
"type": "not_found",
"code": "not_found",
"message": "Ressourcen findes ikke.",
"request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
"doc_url": "https://grundfast.dk/docs/fejl#not_found"
}Prøv det
Live-kald fra siden
Kræver din nøgleBruges ofte sammen med
- GETList DAGI-temaer
/v1/dagi - GETHent et område
/v1/dagi /:tema /:kode - POSTHent mange områder
/v1/dagi:batch
Læs mere om DAGI, og hvad data kan bruges til, på produktsiden.