Μπορώ να φιλτράρω τις αγγελίες;
Ναι. Το GET /v1/properties δέχεται τα φίλτρα που αναφέρονται παρακάτω. Μια παράμετρος που δεν ορίζει απορρίπτεται με invalid_parameter και ποτέ δεν αγνοείται σιωπηρά.
- country (υποχρεωτική): ο κωδικός ISO 3166-1 alpha-2 της χώρας, για παράδειγμα TH
- listing_type: all (η προεπιλογή), sale ή rent
- property_type: ένας τύπος ακινήτου, για παράδειγμα condominium
- province_id, city_id και area_id: μια τοποθεσία, με βάση τα αναγνωριστικά που περιέχουν οι αγγελίες
- city και area: μια τοποθεσία, με βάση το όνομα, χωρίς διάκριση πεζών-κεφαλαίων
- min_price και max_price: ένα εύρος τιμών, στο νόμισμα της ίδιας της αγγελίας
- limit: πόσες αγγελίες περιέχει μια σελίδα, έως το μέγιστο που αναφέρει η τεκμηρίωση αναφοράς
- cursor: το next_cursor της προηγούμενης σελίδας
Χρησιμοποιήστε είτε city είτε city_id, και είτε area είτε area_id, όχι και τα δύο. Μια ανορθόγραφη ή άγνωστη παράμετρος απορρίπτεται με invalid_parameter (HTTP 400) αντί να αγνοηθεί, ώστε ένα τυπογραφικό λάθος να μην μπορεί να επιστρέψει αθόρυβα μια σελίδα χωρίς φίλτρα.