API каталогов автозапчастей для вашего проекта
Получайте данные автомобиля по VIN/FRAME, дерево OEM-каталога, схемы и номера деталей через серверный REST API. Встраивайте подбор в свой интерфейс магазина или портала.
Что можно получить через API
1. Найти автомобиль
По VIN, номеру кузова FRAME или шасси — в зависимости от каталога. Для поддерживаемых марок доступен и подбор по параметрам.
2. Открыть схему
Перейдите по разделам каталога к нужному узлу. Схема и список позиций помогают связать изображение с каталожным номером.
3. Перейти к покупке
Используйте найденный OEM-номер в своём магазине. Цены, наличие и заказы остаются в вашей системе; в виджете настраивается ссылка на поиск цены или заявку.
Перед оплатой проверьте нужные марки, модели и годы на своих примерах. Покрытие VIN/FRAME, состав схем и данные деталей зависят от конкретного каталога.
Как проходит серверная интеграция
- Активируйте Trial для своего проекта и выпустите серверный Bearer-токен в кабинете. Храните его на backend.
- Определите автомобиль запросом /vehicles/resolve и сохраните vehicle_hash из ответа.
- Получите группы каталога, выберите схему и запросите детали. Передавайте тот же vehicle_hash по всей цепочке.
curl -X POST 'https://api.vinalfa.com/oem/v2/vehicles/resolve' \
-H 'Authorization: Bearer YOUR_SERVER_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"identifier":"YOUR_VIN_OR_FRAME"}'Открыть описание методов, ограничений и ответов API →
Если нужен готовый интерфейс каталога, а не собственная разработка, начните с встраиваемого виджета. Виджет для сайта →
Стоимость подключения и проверка Trial
Trial даёт 5 дней и 10 VIN для проверки подключения. После проверки выберите тариф по реальному объёму работы. Стоимость подписки и услуги разработки сайта — разные статьи расходов.
В подписку входят доступ к каталогам и функции выбранного тарифа. Установка по инструкции самостоятельная; персональная интеграция и разработка магазина согласуются отдельно.
Вопросы перед подключением
Можно подключить каталог бесплатно?
Для первой проверки предусмотрен Trial: 5 дней и 10 VIN. Это временный тестовый доступ. Для дальнейшей работы нужна активная платная подписка.
Входят ли цены и остатки поставщиков?
Vinalfa помогает найти OEM-номер и схему. Источник цен, складские остатки, корзина и оформление заказа остаются на стороне вашего магазина.
Поддерживается любой VIN?
Покрытие зависит от марки, модели, года и данных каталога. Проверьте рабочие примеры в демо и Trial до выбора платного тарифа.
Можно разместить серверный токен в браузере?
Нет. Bearer-токен API хранится на вашем сервере. Для готового интерфейса в браузере используется отдельный публичный токен виджета с настройками проекта.