Каталог по маркам — теперь по VIN

Vindec — VIN-декодер для Каталога по маркам FAPI: API, которому вы передаёте VIN и в ответ получаете модификацию автомобиля и её идентификаторы в каталоге. По этим идентификаторам каталог открывается сразу на нужной модификации, без ручного выбора «марка — модель — модификация».

Vindec не отдаёт запчасти и не строит иерархию марок. Запчасти даёт Каталог по маркам, применимость — База применимости автозапчастей.

Что возвращает VIN-декодер

На вход — 17-символьный VIN, на выход — JSON:

• страна, производитель, модель, модификация, модельный год, годы выпуска модификации;
• мощность в кВт и л.с., объём в см³, тип и код двигателя, тип топлива, кузова, привода, КПП;
• идентификаторы марки, модели и модификации для входа в Каталог по маркам;
• уровень уверенности: exact, partial, brand_only или unknown.

Если VIN расшифрован не полностью, ответ приходит с уровнем partial или brand_only, и в нём заполнены только установленные поля, например только производитель. Догадок Vindec не возвращает: в таком случае модификацию выбирают вручную.

Японские автомобили с номером кузова вида XXX-1234567 и старые ВАЗ с номерами вне стандарта ISO 3779 получают уровень unknown.

Vindec работает для всех марок и моделей, по которым есть данные в Каталоге по маркам FAPI.

Кому

• Витрине или 1С-фронту с Каталогом по маркам FAPI. Vindec встраивается как ещё одна точка входа: вместо выбора марки и модели клиент вводит VIN.
• Тем, кто работает с каталогом через API. Покупать Каталог целиком, чтобы подключить Vindec, не нужно: по идентификаторам модификации подбор продолжается в Каталоге по маркам через API, по весам методов подписки.
• Тем, кто купил каталог целиком. По идентификаторам из ответа подбор продолжается в купленном вами каталоге.

Цена

Оплата за запрос, с заранее пополненного баланса в рублях. Абонентской платы нет.

Полная расшифровка — ответ с уровнем exact, частичная — с уровнем partial. Ответ с уровнем brand_only или unknown бесплатен. Ошибка тоже ничего не стоит.

Повторный запрос того же VIN в течение 24 часов после оплаченного ответа бесплатен, даже если баланс уже закончился.

Деньги пакета действуют 30 дней с покупки, неизрасходованный остаток сгорает. Пока на балансе есть деньги пакета, запросы списываются по цене пакета, потом — по цене универсального тарифа. Когда баланс закончился, запросы не выполняются, пока баланс не пополнят. Долга не бывает.

Как подключить VIN API

1. Войдите на id.iisis.ru и на странице «Ключи» выпустите ключ. Доступ к Vindec в нём отмечен по умолчанию.
2. Пополните баланс Vindec: напишите нам, пришлём способы оплаты. Чек присылайте на fapi@iisis.ru, сумму зачислим на баланс.
3. Передавайте ключ в заголовке Authorization: Bearer <ключ>. VIN расшифровывает метод /vin API каталога FAPI: REST, JSON; описание метода — в спецификации API.

Пробные кредиты API каталога расшифровку VIN не оплачивают: VIN списывается только с баланса Vindec. Пополнить его можно и на пробном доступе.

Остаток баланса виден в ответе метода /usage того же API; этот метод бесплатен.

Приватность VIN

VIN из запроса записывается в журнал запросов вместе с вашим номером клиента: по этой записи списывается оплата и распознаётся бесплатный повтор того же VIN в течение 24 часов. Данные своих покупателей вы передаёте как оператор, а мы обрабатываем VIN по вашему поручению (ч. 3 ст. 6 152-ФЗ). Если вам нужны особые условия по данным, они записываются отдельным пунктом в договор. Как мы обрабатываем персональные данные — в политике обработки персональных данных.

Часто задаваемые вопросы

Написать нам

Читать дальше: Продукты FAPI — остальные инструменты для магазина автозапчастей.