Fejlkatalog

Alle HTTP-statusser, API’et kan svare med, opdelt i fejltyper, med hvad du skal gøre ved hver — maskinlæsbart og uden nøgle.

GEThttps://api.grundfast.dk/v1/errors

Kataloget er den samme liste, som Fejl og statuskoder viser, og som API’et selv er kontrolleret imod: en ny fejlstatus kan ikke tages i brug, uden at den står her. Brug det fx til at bygge din egen retry-logik eller til at vise en forståelig besked.

Hver post har status, en stabil type, en kort engelsk title, en dansk beskrivelse, retry (nej, retry-after, backoff eller senere), taeller_i_kvote og et eksempel på fejlteksten. Selve fejlsvaret er stadig kun { "error": "…" } — type er katalogets nøgle, ikke et felt i svaret. Svaret må caches i en time.

Godkendelse · Åbent

Kræver ingen nøgle. Kaldet er begrænset pr. IP-adresse.

Afregning

Gratis og uden nøgle; begrænset til 60 kald i minuttet pr. IP-adresse.

Eksempel

curl "https://api.grundfast.dk/v1/errors"

Svar · eksempel, forkortet200json

{
  "antal": 18,
  "fejl": [
    {
      "status": 400,
      "type": "invalid_request",
      "title": "Bad Request",
      "beskrivelse": "Ugyldig forespørgsel: forkert BFE- eller UUID-format, en manglende eller for kort parameter, et koordinat uden for Danmark, en ugyldig `asOf`, `srid`, `cirkel` eller `polygon`, eller et body, der ikke passer til skemaet.",
      "retry": "nej",
      "taeller_i_kvote": true,
      "eksempel": "invalid BFE number"
    },
    {
      "status": 401,
      "type": "invalid_api_key",
      "title": "Unauthorized",
      "beskrivelse": "Nøglen mangler, er ugyldig, udløbet eller tilbagekaldt. Svaret bærer en `WWW-Authenticate`-header, der beskriver formatet.",
      "retry": "nej",
      "taeller_i_kvote": false,
      "eksempel": "invalid API key"
    },
    {
      "status": 402,
      "type": "plan_required",
      "title": "Payment Required",
      "beskrivelse": "Funktionen er ikke med i din plan. Batch og webhooks kræver Pro; eksport og historik (`asOf` og `/historik`) kræver Scale. Beskeden nævner den plan, der skal til.",
      "retry": "nej",
      "taeller_i_kvote": false,
      "eksempel": "this feature requires the Pro plan or higher; …"
    }
  ],
  "meta": {
    "kilde": "Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Felter i svaret

fejl[].statusinteger: HTTP-statussen. Samme status kan have flere fejltyper, fx 429.
fejl[].typestring: Fejltypens stabile nøgle, fx quota_exceeded eller rate_limited.
fejl[].retry'nej' | 'retry-after' | 'backoff' | 'senere': Om og hvordan du prøver igen: aldrig uændret, efter Retry-After, med eksponentiel backoff, eller når forudsætningen er opfyldt.
fejl[].taeller_i_kvoteboolean: Om et svar af denne type bruger en enhed af månedens kvote.

Statuskoder

Status	Betydning
200	Svaret er leveret.
429	Mere end 60 kald i minuttet fra samme IP-adresse. Se `Retry-After`.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Åbent endpoint

Bruges ofte sammen med

curl "https://api.grundfast.dk/v1/errors"

Svar · eksempel, forkortet200json

{
  "antal": 18,
  "fejl": [
    {
      "status": 400,
      "type": "invalid_request",
      "title": "Bad Request",
      "beskrivelse": "Ugyldig forespørgsel: forkert BFE- eller UUID-format, en manglende eller for kort parameter, et koordinat uden for Danmark, en ugyldig `asOf`, `srid`, `cirkel` eller `polygon`, eller et body, der ikke passer til skemaet.",
      "retry": "nej",
      "taeller_i_kvote": true,
      "eksempel": "invalid BFE number"
    },
    {
      "status": 401,
      "type": "invalid_api_key",
      "title": "Unauthorized",
      "beskrivelse": "Nøglen mangler, er ugyldig, udløbet eller tilbagekaldt. Svaret bærer en `WWW-Authenticate`-header, der beskriver formatet.",
      "retry": "nej",
      "taeller_i_kvote": false,
      "eksempel": "invalid API key"
    },
    {
      "status": 402,
      "type": "plan_required",
      "title": "Payment Required",
      "beskrivelse": "Funktionen er ikke med i din plan. Batch og webhooks kræver Pro; eksport og historik (`asOf` og `/historik`) kræver Scale. Beskeden nævner den plan, der skal til.",
      "retry": "nej",
      "taeller_i_kvote": false,
      "eksempel": "this feature requires the Pro plan or higher; …"
    }
  ],
  "meta": {
    "kilde": "Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.