Bolehkah saya menapis penyenaraian?
Ya. GET /v1/properties menerima penapis yang disenaraikan di bawah. Parameter yang tidak ditakrifkan olehnya ditolak dengan invalid_parameter, tidak sekali-kali diabaikan secara senyap.
- country (diwajibkan): kod ISO 3166-1 alpha-2 bagi negara tersebut, contohnya TH
- listing_type: all (lalai), sale atau rent
- property_type: satu jenis hartanah, contohnya condominium
- province_id, city_id dan area_id: sesuatu tempat, mengikut pengecam yang dibawa oleh penyenaraian
- city dan area: sesuatu tempat, mengikut nama, dipadankan tanpa mengira huruf besar atau kecil
- min_price dan max_price: julat harga, dalam mata wang penyenaraian itu sendiri
- limit: bilangan penyenaraian dalam satu halaman, sehingga had maksimum dalam rujukan
- cursor: next_cursor daripada halaman sebelumnya
Gunakan sama ada city atau city_id, dan sama ada area atau area_id, bukan kedua-duanya. Parameter yang salah eja atau tidak dikenali ditolak dengan invalid_parameter (HTTP 400) dan bukannya diabaikan, jadi kesilapan menaip tidak boleh secara senyap mengembalikan halaman tanpa penapis.