Fouten en lookupstatussen.

Controleer HTTP-status én de status in de JSON. Een ontbrekend adres is in dit contract een lookupresultaat met HTTP 200.

HTTP-statussen
HTTP	Betekenis	Aanpak
200	Request verwerkt	Lees ok, not_found of ambiguous
401	Invalid API key	Controleer de serverconfiguratie en accountstatus
422	Ontbrekende of ongeldige invoer	Herstel postcode, huisnummer of toevoeging
429	Quota overschreden	Respecteer Retry-After
503	Quota service unavailable	Stel nieuwe pogingen uit en houd handmatige invoer beschikbaar
5xx / netwerkfout	Server- of transportprobleem	Gebruik een begrensde timeout en handmatige fallback

Resultaatstatussen bij HTTP 200

Lookupstatus
status	address	candidates	Betekenis
ok	Object met straat en woonplaats	Lege array	Eén unieke combinatie gevonden
not_found	null	Lege array	Geen match in de dataset
ambiguous	null	Array met straat-/woonplaatsobjecten	Meer dan één verschillende combinatie gevonden

Een not_found-resultaat wordt niet als HTTP 404 teruggegeven door de huidige adreslookuproute. Een onbekend API-pad kan wel HTTP 404 geven.

Een ontbrekend resultaat verwerken

{
  "status": "not_found",
  "request": {
    "postcode": "1012JS",
    "huisnummer": 1,
    "toevoeging": null
  },
  "address": null,
  "candidates": []
}

Illustratieve responsevorm, geen live lookup van dit postcode/huisnummerpaar.

Laat de gebruiker straat en woonplaats zelf invullen. Kies bij ambiguous niet stilzwijgend de eerste kandidaat.

Veilige troubleshooting

Controleer host, pad, invoer en HTTP-status. Leg alleen noodzakelijke technische informatie vast. Log geen API-keys, headers met secrets, keylabels, e-mailadressen of volledige accountresponses.

Nederlandse invoer controleren Quota en Retry-After Authenticatie

Contract gecontroleerd op 30 september 2026 aan de hand van de huidige API-broncode. De actieve accountlimits vind je in Mijn account.