Посібники

Синтаксис фільтрів пошуку

Фільтри передаються в рядку запиту /cars. Усі вони необов’язкові й поєднуються через AND.

Пропускайте невикористані фільтри

Ніколи не надсилайте порожнє значення, як-от domain_id= чи page=. Просто не додавайте параметр.

Джерело й авто

domain_id=3 – це Copart, а domain_id=1 – IAAI. Він вибирає авто з відповідним лістингом; їхні вкладені lots можуть містити інші джерела, тож читайте lots[].domain.id.

Кілька виробників

manufacturer_id приймає один рядок з 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 нічому не відповідає в довіднику, фільтр не застосовується.