هل يمكنني تصفية العقارات؟
نعم. يقبل 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) بدلًا من تجاهله، فلا يمكن لخطأ إملائي أن يُعيد بصمت صفحة غير مصفّاة.

