Документация

Описание доступных методов для работы с сервисами Levam.

OEM Виджет

Виджет OEM каталогов позволяет самостоятельно подключить ОЕМ каталоги абсолютно к любому сайту. Без долгой и затратной интеграции каталогов через API силами программистов. Пример виджета можно посмотреть в демо.

Преимущества использование виджета:

Установка:

Просто скопируйте на страницу своего сайта (на которой хотите разместить каталоги) код виджета из кабинета <script id="levam_oem_catalog" src="https://widgets.levam.net/oem-widget/loader.js" code="xxxxxx" async></script>

Если вы хотите отображать на странице только один какой-то каталог - укажите его в параметре start_brand например:
<script start_brand="bmw" id="levam_oem_catalog" src="https://widgets.levam.net/oem-widget/loader.js" code="xxxxxx" async></script>

Для изменения языка каталогов используйте параметр lang например:
<script lang="de" id="levam_oem_catalog" src="https://widgets.levam.net/oem-widget/loader.js" code="xxxxxx" async></script>
Внимание для возможности использовать все языки нужен мультиязычный доступ.

JavaScript API:

levamVinFind("vincode") - позволяет инициировать поиск по VIN-номеру. Обычно используется для реализации поиска по VIN-номеру на своем сайте из собственного поля - например из основного поиска по сайту. При этом поле поиска по вин в самом виджете можно отключить в кабинете. Метод необходимо вызывать на странице где размещен виджет.






Levam OEM API

CatalogsListGet

Вывод информации по каталогам

Адрес:

https://api.levam.net/oem/v1/CatalogsListGet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/CatalogsListGet?api_key=key&type=

Ответ:

Описание ответа:

name Название каталога
code Код каталога (устаревший параметр оставлен для совместимости, его значение совпадает с catalog_code)
catalog_code Код каталога
logo Логотип каталога 100*100
logo_small Маленький логотип каталога 50*50
supportframesearch Поддерживает ли данный каталог поиск по фрейму
frameexample Пример фрейма для данного каталога
supportvinsearch Поддерживает ли данный каталог поиск по VIN-номеру
vinexample Пример VIN-номера для данного каталога
universal_classifier Для данного каталога доступен универсальный классификатор - методы (TreeGet,TreeNodeSearch,TreeNodePartsGet), принимает значения yes/no
type_moto Наличие в данном каталоге мотоциклов
type_auto Наличие в данном каталоге легковых автомобилей
type_transport Наличие в данном каталоге грузовых и коммерческих транспортных средств

ModelsListGet

Внимание метод объявлен устаревшим - используйте ModelsListGet2

Вывод всех семейств и моделей одного производителя.

Адрес:

https://api.levam.net/oem/v1/ModelsListGet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/ModelsListGet?api_key=key&catalog_code=3&type=

Ответ:

Описание ответа:

name Название каталога
code Код каталога (устаревший параметр оставлен для совместимости, его значение совпадает с catalog_code)
catalog_code Код каталога
logo Логотип каталога 100*100
logo_small Маленький логотип каталога 50*50
supportframesearch Поддерживает ли данный каталог поиск по фрейму
frameexample Пример фрейма для данного каталога
supportvinsearch Поддерживает ли данный каталог поиск по VIN-номеру
vinexample Пример VIN-номера для данного каталога
universal_classifier Для данного каталога доступен универсальный классификатор - методы (TreeGet,TreeNodeSearch,TreeNodePartsGet), принимает значения yes/no
type_moto Наличие в данном каталоге мотоциклов
type_auto Наличие в данном каталоге легковых автомобилей
type_transport Наличие в данном каталоге грузовых и коммерческих транспортных средств

ModelsListGet2

Вывод всех семейств и моделей одного производителя.

Адрес:

https://api.levam.net/oem/v1/ModelsListGet2

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/ModelsListGet2?api_key=key&catalog_code=3&type=

Ответ:

Описание ответа:

name Название каталога
code Код каталога (устаревший параметр оставлен для совместимости, его значение совпадает с catalog_code)
catalog_code Код каталога
logo Логотип каталога 100*100
logo_small Маленький логотип каталога 50*50
supportframesearch Поддерживает ли данный каталог поиск по фрейму
frameexample Пример фрейма для данного каталога
supportvinsearch Поддерживает ли данный каталог поиск по VIN-номеру
vinexample Пример VIN-номера для данного каталога
universal_classifier Для данного каталога доступен универсальный классификатор - методы (TreeGet,TreeNodeSearch,TreeNodePartsGet), принимает значения yes/no
type_moto Наличие в данном каталоге мотоциклов
type_auto Наличие в данном каталоге легковых автомобилей
type_transport Наличие в данном каталоге грузовых и коммерческих транспортных средств

VehicleParamsSet

Уточнение модификации выбранной модели автомобиля.

Адрес:

https://api.levam.net/oem/v1/VehicleParamsSet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/VehicleParamsSet?api_key=key&catalog_code=3&model=AA3&ssd=&family=Audi+A3

Ответ:

Описание ответа:

mark Бренд транспортного средства
catalog_code Код каталога
family Семейство транспортного средства
model Модель транспортного средства
ssd Уникальный идентификатор
param Выбранные параметры
modification Выбранная модификация
group Выбранная группа
subgroup Выбранная подгруппа
vin VIN-номер
frame Frame номер
universal_classifier Для данного каталога доступен универсальный классификатор - методы (TreeGet,TreeNodeSearch,TreeNodePartsGet), принимает значения yes/no
name Полное название параметра
values Массив параметров, где ключом является полное название значения параметра, а значением - код значения параметра

VehicleModificationsGet

Выбор модификации транспортного средства в соответствии с выбранными ранее параметрами.

Адрес:

https://api.levam.net/oem/v1/VehicleModificationsGet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/VehicleModificationsGet?api_key=key&ssd=770e1aee96bbf85678ab1426f66af8c6<

Ответ:

Описание ответа:

mark Бренд транспортного средства
catalog_code Код каталога
family Семейство транспортного средства
model Модель транспортного средства
ssd Уникальный идентификатор
param Выбранные параметры
modification Выбранная модификация
group Выбранная группа
subgroup Выбранная подгруппа
vin VIN-номер
frame Frame номер
universal_classifier Для данного каталога доступен универсальный классификатор - методы (TreeGet,TreeNodeSearch,TreeNodePartsGet), принимает значения yes/no

PartGroupsGet

Выбор группы запчастей для выбранной модификации транспортного средства.

Адрес:

https://api.levam.net/oem/v1/PartGroupsGet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/PartGroupsGet?api_key=key&ssd=770e1aee96bbf85678ab1426f66af8c6&link=dm5GNk8vOXNQN1pBWmZTUjU4WnhpMW4wbnZpY29NZzBRLzg4Tk1HVlBZZz0=

Ответ:

Описание ответа:

mark Бренд транспортного средства
catalog_code Код каталога
family Семейство транспортного средства
model Модель транспортного средства
ssd Уникальный идентификатор
param Выбранные параметры
modification Выбранная модификация
group Выбранная группа
subgroup Выбранная подгруппа
vin VIN-номер
frame Frame номер
date Дата и время создания уникального идентификатора ssd
full_name Полное название группы
group_name Код группы запчастей
image Изображение для данной группы

PartsGet

Вывод запчастей, диаграмм и координат.

Адрес:

https://api.levam.net/oem/v1/PartsGet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/PartsGet?api_key=key&ssd=770e1aee96bbf85678ab1426f66af8c6&link=dm5GNk8vOXNQN1pBWmZTUjU4WnhpMW4wbnZpY29NZzBRLzg4Tk1HVlBZZz0=&subgroup=010-10000

Ответ:

Описание ответа:

parts Информация о найденных запчастях. Состоит из двух частей: standart и add.
standart представляет из себя массив информации о деталях, имеющуюся для всех деталей во всех каталогах. Этот массив состоит из:
  • part_number - обозначение детали на чертеже
  • part_code - код детали
  • part_name - название детали
  • part_quantity - количество необходимых деталей.

add представляет из себя массив дополнительной информации о детали. Этот массив состоит из:
  • info - дополнительная информация о детали
  • model - указывает период производства данной детали.
  • type - принимает два значения
    • link - ссылка на другой узел
    • annotation - аннтоция к группе деталей идущих дальше по списку или ко всему узлу
    • part - деталь
    • replacment - оригинальная замена детали идущей выше по списку
  • node_link Ссылка на узел, если ссылки нет то значение поле будет no
image Чертежи узла, соответствующие выбранной подгруппе
coord Информация о координатах, наобходимых для поиска запчастей на чертежах

VinFind

Поиск транспортного средства по VIN-номеру

Адрес:

https://api.levam.net/oem/v1/VinFind

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/VinFind?api_key=key&vin=WAUBA24B3XN104537

Ответ:

Описание ответа:

mark Бренд транспортного средства
catalog_code Код каталога
family Семейство транспортного средства
model Модель транспортного средства
ssd Уникальный идентификатор
param Выбранные параметры
modification Выбранная модификация
group Выбранная группа
subgroup Выбранная подгруппа
vin VIN-номер
frame Frame номер

FrameFind

Поиск транспортного средства по FRAME номеру

Адрес:

https://api.levam.net/oem/v1/FrameFind

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Выходные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/FrameFind?api_key=key&frame=NHW20-7837381

Ответ:

Описание ответа:

mark Бренд транспортного средства
catalog_code Код каталога
family Семейство транспортного средства
model Модель транспортного средства
ssd Уникальный идентификатор
param Выбранные параметры
modification Выбранная модификация
group Выбранная группа
subgroup Выбранная подгруппа
vin VIN-номер
frame Frame номер

TreeGet

Вывод дерева узлов универсального классификатора для транспортного средства

Адрес:

https://api.levam.net/oem/v1/TreeGet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/TreeGet?api_key=key&link=link&ssd=ssd&lang=ru

Ответ:

Описание ответа:

TreeNodeSearch

Вывод списка узлов для выбранной ветки универсального классификтора

Адрес:

https://api.levam.net/oem/v1/TreeNodeSearch

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/TreeNodeSearch?api_key=key&link=link&&ssd=ssd&path=1->3->4&lang=ru

Ответ:

Описание ответа:

TreeNodePartsGet

Вывод деталей узла выбранного из списка

Адрес:

https://api.levam.net/oem/v1/TreeNodePartsGet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/TreeNodePartsGet?api_key=key&link=link&ssd=ssd&group=300-300020&lang=ru

Ответ:

Описание ответа:

TreeFullGet

Вывод полного дерева узлов универсального классификатора

Адрес:

https://api.levam.net/oem/v1/TreeFullGet

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/TreeFullGet?api_key=key&ssd=5cb2c0bccb14128d1982948b719715c8:28bddf035b3bacac1bc42f2f33359651&lang=ru&link=SzNxekJ4aC9jVyswNC9mTjNjM3B5QT09--

Ответ:

Описание ответа:

mark - Бренд транспортного средства
catalog_code - Код каталога
model - Название модели
family - Название семейства
ssd - Уникальный идентификатор
param - Выбранные параметры
modification - Выбранная модификация
group - Выбранная группа
subgroup - Выбранная подгруппа
universal_classifier - Для данного каталога доступен универсальный классификатор
vin - VIN-номер транспортного средства
frame - Номер рамы
10000 - id раздела дерева
name - Название раздела дерева универсального классификатора
image - Ссылка на изображение раздела дерева универсального классификатора
branch - Ветка дерева
nodes - Массив содержащий информацию об узле

ApplicabilityCars

Вывод каталога, семейства, модели и модификации, в которых встречается деталь.

Адрес:

https://api.levam.net/oem/v1/ApplicabilityCars

Входные параметры:

Обязательные параметры:

Необязательные параметры:

Пример:

https://api.levam.net/oem/v1/ApplicabilityCars?api_key=key&part_code=34351543830&lang=ru

Ответ:

Описание ответа:

  • catalog_code - Код каталога
    		•
  • catalog_name - Название каталога
    		•
  • families - Массив объектов, содержащий информацию о семействах:
  • family_name - Название семейства
    		•
  • models - Массив объектов, содержащий информацию о моделях:
  • model_name - Название модели
    		•
  • model_image - Ссылка на изображение модели
    		•
  • modifs - Массив объектов, содержащий информацию о модификациях:
    		•
  • modif_link - Код выбранной модификации
    		•
  • props - Объект, содержащий параметры модификации (названия полей могут отличаться в разных каталогах)
    		•

    ApplicabilityNodes

    Вывод модификации с узлами, в которых есть заданная деталь.

    Адрес:

    https://api.levam.net/oem/v1/ApplicabilityNodes

    Входные параметры:

    Обязательные параметры:

    Необязательные параметры:

    Пример:

    https://api.levam.net/oem/v1/ApplicabilityNodes?api_key=key&part_code=057130764AM&modif_link=UFNINUtxVHpxcmJNZmUrcVNoeS83UT09--

    Ответ:

    Описание ответа:

  • catalog_code - Код каталога
    		•
  • catalog_name - Название каталога
    		•
  • family_name - Название семейства
    		•
  • model_name - Название модели
    		•
  • model_image - Ссылка на изображение модели
    		•
  • nodes - Массив объектов, содержащий информацию об узлах:
    		•
  • image - Ссылка на изображение узла
    		•
  • node_name - Название узла
    		•
  • group - Код/название группы
    		•
  • parts - Массив объектов, содержащий информацию о деталях узла:
    		•
  • pnc - Номер детали на схеме
    		•

    OrderCheck

    Отправляет запрос на проверку заказа

    Адрес:

    https://api.levam.net/oem/v1/OrderCheck

    Входные параметры:

    Обязательные параметры:

    Необязательные параметры:

    Пример:

    https://api.levam.net/oem/v1/OrderCheck?api_key=key&vin=WBAUB31060VH40246&parts_codes=24007572464&order_code=1234

    Ответ:

    Описание ответа:

    OrderCheckResult

    Возвращает результат проверки заказа

    Адрес:

    https://api.levam.net/oem/v1/OrderCheckResult

    Входные параметры:

    Обязательные параметры:

    Пример:

    https://api.levam.net/oem/v1/OrderCheckResult?api_key=key&task_id=4c9caf3deb6cad4eb73a7f7f9c679e57

    Ответ:

    Описание ответа:

    MaintenanceParts

    Вывод всех запчастей для технического обслуживания

    Адрес:

    https://api.levam.net/oem/v1/MaintenanceParts

    Входные параметры:

    Обязательные параметры:

    Необязательные параметры:

    Пример:

    https://api.levam.net/oem/v1/MaintenanceParts?api_key=key&lang=en&modif_link=OTM5SElaM2orZi91OUZyNVNrTWwydz09--

    Ответ:

    Описание ответа:

    Levam AM

    BrandsGet

    Получение списка возможных брендов по номеру детали

    Адрес:

    https://am-api.levam.net/v1/BrandsGet

    Входные параметры:

    Обязательные параметры:

    Необязательные параметры:

    Выходные параметры:

    Обязательные параметры:

    Необязательные параметры:

    Пример:

    https://am-api.levam.net/v1/BrandsGet?api_key=key&part_number=123456789&lang=ru

    Ответ:

    Описание ответа:

    search_number Номер запчасти очищенный от спец символов и пробелов
    part_number Номер запчасти в формате производителя
    brand_name Название бренда
    aliases Синонимы бренда
    part_name Название запчасти
    images Массив изображений запчасти
    images_small Массив уменьшенных изображений запчасти

    ReplacementsGet

    Получение списка замен по номеру детали и бренду

    Адрес:

    https://am-api.levam.net/v1/ReplacementsGet

    Входные параметры:

    Обязательные параметры:

    Необязательные параметры:

    Выходные параметры:

    Обязательные параметры:

    Необязательные параметры:

    Пример:

    https://am-api.levam.net/v1/ReplacementsGet?api_key=key&part_number=12345&brand=OPTIMAL&lang=ru

    Ответ: