Spring til indhold

Grundfast

List DAGI-temaer

Hvilke administrative inddelinger API’et kender, og hvor mange områder hver af dem har.

GET/v1/dagi

Et 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"
Svar · fra demo-endpointet200
{
  "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

StatusBetydning
200Svaret er leveret.
429For 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.

Fejlsvar · 404
{
  "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 endpoint

Endpointet er åbent — kaldet sendes uden nøgle.

GET /v1/dagi

Bruges ofte sammen med

Læs mere om DAGI, og hvad data kan bruges til, på produktsiden.