Οδηγός ενσωμάτωσης του Housing Market API
Οι πίνακες αναφοράς, οι περιγραφές των τελικών σημείων, οι κωδικοί σφαλμάτων και τα παραδείγματα παράγονται από την προδιαγραφή του API και παραμένουν στα αγγλικά σε κάθε γλώσσα. Τα ονόματα, οι παράμετροι και οι κωδικοί είναι παντού ίδιοι.
Σελιδοποίηση
Κάθε τελικό σημείο λίστας χρησιμοποιεί δείκτες (cursors). Μια απόκριση περιέχει data, next_cursor και has_more.
Περάστε το next_cursor μιας απόκρισης ως cursor του επόμενου αιτήματος και σταματήστε όταν το has_more είναι false.
Δεν υπάρχει σύνολο ούτε αριθμοί σελίδων. Αυτό είναι σκόπιμο: το API έχει σχεδιαστεί για αναζήτηση αγγελιών, όχι για αντιγραφή της βάσης δεδομένων.
Η παράμετρος limit ορίζει το μέγεθος της σελίδας. Η προεπιλογή είναι 50 και δεν μπορεί να υπερβαίνει το 100.
Ένας δείκτης είναι αδιαφανής. Μην τον αναλύετε, μην κατασκευάζετε δικό σας και μην τον φυλάτε για αργότερα. Είναι συνδεδεμένος με το κλειδί σας και με τα φίλτρα του αιτήματος που τον παρήγαγε, και ένας μη έγκυρος δείκτης απορρίπτεται με invalid_cursor.
Τα αποτελέσματα έρχονται με σταθερή σειρά μέσα σε μία διάσχιση, αλλά η σειρά δεν έχει καμία σημασία. Μην βασίζεστε σε αυτήν.
Response shape
| Field | Type | Description |
|---|---|---|
data required | array | The items on this page. |
next_cursor required | string | null | Pass as cursor to get the next page. Null on the last page. |
has_more required | boolean | False when there is no further page. |
Request parameters
| Parameter | Type | Required | Values | Description |
|---|---|---|---|---|
limit | integer | no | default 50min 1max 100 | Page size. At most the maximum shown; larger values are refused with invalid_parameter. |
cursor | string | no | The next_cursor of the previous page. Opaque: do not parse it, store
it, or build one. It is bound to your key and to the filters of the
request that produced it, and a cursor used with different filters is
refused with invalid_cursor. |