Техническое задание: Подбор по VIN с интеграцией каталогов через API

Цель

Реализовать на сайте возможность поиска запчастей по VIN-номеру, привязанную к внешним каталогам через API. Пользователь вводит VIN и получает список запчастей, доступных к заказу и соответствующих его автомобилю.

Требования к функционалу

• Поле ввода VIN-номера на сайте (классический формат из 17 символов).
• Интеграция с API сторонних каталогов запчастей для получения списка деталей по VIN.
• Отображение результатов в реальном времени или после перенаправления на страницу результатов.
• Фильтр и сортировка (по категории, цене, наличию).
• Индикация наличия на складе.
• Кнопка «Перейти к заказу» или «Добавить в корзину» для каждой найденной запчасти.

Технические детали

• Интеграция должна быть быстрой и не конфликтовать с другими API на сайте.
• Кеширование данных для ускорения ответов по часто запрашиваемым VIN.
• Обработка ошибок на стороне API: красивый fallback (например, «Не удалось найти данные по вашему VIN»).
• Мобильная версия поля поиска и результатов — адаптивный дизайн.
• Логирование VIN-запросов для анализа (частота, успешность, ошибки).

Критерии приёмки

• Корректная работа для VIN как в сервисе-аналоге (минимум 3 тестовых VIN должны возвращать результат).
• Выводим фотографию, артикул, название детали, цену, наличие, номер OEM.
• В админке — простой блок отчётности по интеграции (сколько API-запросов выполнено, сколько ошибок).

Полная инфраструктура для одного API поставляется аналог готовой.