List DAGI-temaer
Hvilke administrative inddelinger API’et kender, og hvor mange områder hver af dem har.
https://api.grundfast.dk/v1/dagiEt lille opslagsindeks: de seks temaer region, kommune, sogn, retskreds, politikreds og opstillingskreds, hver med antallet af områder. Svaret bygges af det medfølgende register og kalder ikke Datafordeler.
Endpointet er åbent og kræver ingen nøgle, så en klient kan finde gyldige tema-værdier, før den har en. Det er begrænset pr. IP-adresse.
Godkendelse · Åbent
Kræver ingen nøgle. Kaldet er begrænset pr. IP-adresse.
Afregning
Gratis — kræver ingen nøgle og tæller ikke i kvoten.
Eksempel
curl "https://api.grundfast.dk/v1/dagi"{
"temaer": [
{
"tema": "region",
"antal": 5
},
{
"tema": "kommune",
"antal": 99
},
{
"tema": "sogn",
"antal": 2097
},
{
"tema": "retskreds",
"antal": 24
},
{
"tema": "politikreds",
"antal": 12
},
{
"tema": "opstillingskreds",
"antal": 92
}
],
"meta": {
"kilde": "Datafordeler DAGI via Grundfast",
"grundfast_version": "0.1.0"
}
}Felter i svaret
temaer[].temastring- Temaets navn, som det bruges i stien til
/v1/dagi/:tema. temaer[].antalinteger- Antal områder i temaet, fx 99 kommuner og 5 regioner.
meta.grundfast_versionstring- Den version af Grundfast, der har leveret svaret.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 429 | For mange kald fra samme IP-adresse. 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
Åbent endpointBruges ofte sammen med
- GETList områder i et tema
/v1/dagi /:tema - GETHent et område
/v1/dagi /:tema /:kode - GETFind områder for et punkt
/v1/dagi /reverse
Læs mere om DAGI, og hvad data kan bruges til, på produktsiden.