الأدلة
صيغة فلاتر البحث
توضع الفلاتر في سلسلة الاستعلام لـ /cars. كلها اختيارية وتُدمج بشرط AND.
احذف الفلاتر غير المستخدمة
لا ترسل أبدًا قيمة فارغة مثل domain_id= أو page=. اترك المعامل خارج الطلب.
المصدر والمركبة
القيمة domain_id=3 تعني Copart وdomain_id=1 تعني IAAI. يختار الفلتر المركبات التي لها إعلان مطابق؛ وقد تتضمن لوتاتها المتداخلة مصادر أخرى، لذا اقرأ lots[].domain.id.
عدة شركات مصنّعة
يقبل manufacturer_id سلسلة واحدة بمعرّفات مفصولة بفواصل، مثل 16,20. لا ترسل مصفوفة.
عدة حالات
استخدم مفاتيح مكررة بأقواس: status[]=4&status[]=5. لا تجمع بين status وstatus[]، ولا ترسل status=[] أبدًا.
البحث برقم VIN
يطابق vin رقم VIN المخزّن كاملًا دون تمييز حالة الأحرف. استخدم _ كحرف بدل: YV1MC_ يطابق كل VIN يبدأ بـ YV1MC. ويقبل search_query رقم VIN أو رقم لوت.
السنوات
القيمة year مطابقة تامة؛ وfrom_year وto_year حدود شاملة. في /cars تُطبَّق معًا.
تواريخ المزادات
المعاملان sale_date_from وsale_date_to تاريخان تقويميان غير شاملين (YYYY-MM-DD). يتقدّم sale_date_from على sale_date_in_days، ويتقدّم without_sale_date=1 على الثلاثة.
المتغيّرة مؤخرًا
تُعيد minutes=60 المركبات المحدّثة خلال الساعة الأخيرة. النطاق المدعوم 1–4320 دقيقة (72 ساعة).
الأسعار والعداد
تستخدم buy_now_price_* وbid_price_* وحدات سعر المصدر المخزّنة دون تحويل أو رسوم. إذا حُدّدت حدود بالكيلومتر والميل معًا، يجب أن يتطابق الاثنان.
الفلاتر النصية
الحقول name وengine_name وdamage وdocument_title مقاطع نصية لا تميّز حالة الأحرف. إذا لم يطابق damage أو document_title أي شيء في قاموسه، لا يُطبَّق الفلتر.