Fejl-formatet (v1 vs. dawa)

1 min læsning

Fejl-formatet

Fejl-formen afhænger af fladen.

/v1/* (native):

JSON

{ "error": {
  "type": "rate_limit_exceeded",
  "message": "Du har overskredet dit forbrugsloft. Prøv igen senere.",
  "code": 429,
  "request_id": "req_ab12cd34",
  "doc_url": "https://danskadresseapi.dk/docs#error-rate_limit_exceeded",
  "debug_url": "https://danskadresseapi.dk/dashboard/debug?req=req_ab12cd34" } }

code er HTTP-tallet (fx 429). type er en streng. Opgiv request_id til support.

/dawa/* (DAWA-form):

JSON

{ "type": "ResourceNotFoundError",
  "title": "The resource was not found",
  "details": { "id": "0a3f50…" } }

Validering: type: "QueryParameterFormatError", details er par-arrays [["param","besked"]].

Begge flader beholder X-RateLimit-*- og Retry-After-headere, så klient-side back-off virker ens.

Var dette nyttigt?