Fouten

Een fout is application/problem+json (RFC 9457) met een vaste code; detail zegt in je Accept-Language wat je kunt doen. Een fout kost geen credits.

{
  "type": "https://huispedia.dev/nl/docs/errors#insufficient_credits",
  "title": "Onvoldoende credits",
  "status": 402,
  "code": "insufficient_credits",
  "detail": "Deze aanroep kost 8 credits; je saldo is 3. Koop credits in het dashboard.",
  "request_id": "req_01M4…",
  "errors": []
}

HTTP	code	Wanneer
400	invalid_request	Het verzoek klopt niet; errors noemt per veld wat er mis is
401	unauthenticated	Geen of onbekende sleutel
401	key_revoked, key_expired	Sleutel ingetrokken of verlopen
402	insufficient_credits	Je saldo dekt de aanroep niet
402	spend_cap_reached	Je uitgavenlimiet van deze maand is bereikt
403	entitlement_required	Dit endpoint hoort niet bij je account
403	ip_not_allowed	IP-adres buiten de lijst van de sleutel
403	account_suspended	Account opgeschort
403	forbidden	Je mag dit niet met dit account
404	not_found	De locator vindt niets
405	method_not_allowed	Deze methode bestaat niet op dit pad
409	address_ambiguous	Meerdere woningen op het adres; errors bevat de kandidaten
409	conflict	De actie botst met de huidige staat; detail zegt wat
422	data_unavailable	De woning of het gebied bestaat, maar deze gegevens zijn er niet voor
429	rate_limited	Limiet per sleutel of account; zie Retry-After
503	upstream_unavailable	Tijdelijk niet beschikbaar; zie Retry-After
503	billing_unavailable	Betalen is op dit moment niet mogelijk
500	internal_error	Een fout aan onze kant; noem het request_id