Integrationsleitfaden für die Housing Market API
Die Referenztabellen, Endpunktbeschreibungen, Fehlercodes und Beispiele werden aus der API-Spezifikation generiert und bleiben in jeder Sprache auf Englisch. Namen, Parameter und Codes sind überall identisch.
Fehlercodes
Jeder Fehler hat einen HTTP-Status und einen JSON-Body mit error und message.
Verzweigen Sie anhand von error, niemals anhand von message: Die Meldung ist für Menschen bestimmt und kann sich ändern. Es können neue Codes hinzukommen; behandeln Sie einen unbekannten Code daher als Fehler des HTTP-Status, mit dem er eintrifft.
HTTP 403 hat vier verschiedene Codes. Lesen Sie den Code, um zu erfahren, welcher vorliegt: ip_not_allowed, key_paused, country_not_entitled oder upgrade_required.
| Code | HTTP | Meaning | What to do |
|---|---|---|---|
invalid_cursor | 400 | The cursor is malformed, expired, or was issued for a different key or different filters. | Start again from the first page with the filters you want. |
invalid_parameter | 400 | A parameter is unknown, malformed or out of range. | Check the parameter name and value against the reference. Unknown parameters are refused, not ignored. |
unauthenticated | 401 | No key was sent, or the key is not recognised or has been revoked. | Send the key in the x-api-key header. Check it in the console. |
country_not_entitled | 403 | The country is not part of your subscription. | Add the country in the console. The same key then covers it. |
ip_not_allowed | 403 | The key is valid but the request came from an address that is not registered for it. | Call GET /v1/ping to see the address we see, then register it in the console. |
key_paused | 403 | The key is paused, for example after an unpaid renewal or while a payment dispute is reviewed. | Open the console to see why. The key resumes automatically once the payment is settled. |
upgrade_required | 403 | The endpoint belongs to the Advanced tier and the key is Standard. | Upgrade in the console. The same key then covers Insights. |
not_found | 404 | The path does not exist, or the listing it names does not exist in that country or has been withdrawn. | Check the path against the reference. For a listing, check the id and the country, and walk the listings again. |
method_not_allowed | 405 | The method is not allowed for this path. Every endpoint is GET. | Use GET. |
quota_exceeded | 429 | The daily or monthly quota for the key has been used. | Wait for the Retry-After period. If you regularly need more, contact support. |
rate_limited | 429 | The per-minute request limit for the key has been reached. | Wait the number of seconds in the Retry-After header, then retry. |
internal_error | 500 | An unexpected error on our side. | Retry later. If it persists, contact support. |
not_configured | 503 | The service is not configured to accept this request yet. | Retry later. |
service_unavailable | 503 | The service is temporarily unable to answer. | Retry later. |