Οδηγός ενσωμάτωσης του Housing Market API
Οι πίνακες αναφοράς, οι περιγραφές των τελικών σημείων, οι κωδικοί σφαλμάτων και τα παραδείγματα παράγονται από την προδιαγραφή του API και παραμένουν στα αγγλικά σε κάθε γλώσσα. Τα ονόματα, οι παράμετροι και οι κωδικοί είναι παντού ίδιοι.
Κωδικοί σφαλμάτων
Κάθε σφάλμα έχει κατάσταση HTTP και σώμα JSON με error και message.
Βασίστε τη λογική διακλάδωσης στο error, ποτέ στο message: το μήνυμα προορίζεται για ανθρώπους και μπορεί να αλλάξει. Ενδέχεται να προστεθούν νέοι κωδικοί, γι' αυτό αντιμετωπίστε έναν άγνωστο κωδικό ως αποτυχία της κατάστασης HTTP με την οποία φτάνει.
Το HTTP 403 έχει τέσσερις διαφορετικούς κωδικούς. Διαβάστε τον κωδικό για να μάθετε ποιος ισχύει: ip_not_allowed, key_paused, country_not_entitled ή 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. |