Grundbegreber

Fejl og statuskoder

Fejl har samme form som i DAWA — og hvert svar har et request-id, du kan sende til os.

Formatet

Fejl på /dawa har samme form som i DAWA, så din eksisterende fejlhåndtering virker uændret:

JSON

{
  "type": "QueryParameterFormatError",
  "title": "One or more query parameters was ill-formed.",
  "details": [["postnr", "Postnummeret skal være 4 cifre"]]
}

details afhænger af typen: ved QueryParameterFormatError er det par af [parameter, besked], ved ResourceNotFoundError det id, der ikke blev fundet ({ "id": "…" }).

Log X-Request-Id. Hvert svar har headeren X-Request-Id. Skriver du til support med den,
kan vi slå præcis dit kald op — uden den kan vi kun gætte ud fra tidspunkt og adresse.

Typerne

Kode	Type	Det du gør
`400`	`QueryParameterFormatError`	Ret parameteren — `details` siger hvilken
`401` / `403`	`AuthorizationError`	Tjek `Authorization`-headeren, eller om planen dækker kaldet
`404`	`ResourceNotFoundError`	Adressen kan være nedlagt — prøv datavask
`429`	`TooManyRequestsError`	Vent — se Rate limits
`5xx`	`InternalServerError` / `ServiceUnavailableError`	Prøv igen med backoff; kontakt os med `X-Request-Id`

To typer er nye i forhold til DAWA. DAWA havde hverken nøgler eller rate limit, så
AuthorizationError og TooManyRequestsError er de eneste fejl, din DAWA-kode ikke har set før.

404 er ikke altid en fejl

Adresser nedlægges, når bygninger rives ned eller veje omlægges. Får du 404 på et id du har gemt, er adressen sandsynligvis historisk — kør den gennem /dawa/datavask/adresser for at finde den nuværende.