Подбор модификации по параметрам

Если VIN неизвестен, модификация подбирается по параметрам: выбираете каталог и модель, затем уточняете параметры (год выпуска, рынок, кузов…), пока не получите список модификаций с кодами link.

Механизм SSD

ssd (Server Side Data) — идентификатор серверной сессии подбора. Первый вызов VehicleParamsSet без ssd создаёт новую сессию и возвращает её идентификатор в client.ssd; все последующие вызовы цепочки должны передавать этот ssd. Сессия хранит выбранный каталог, модель и накопленные параметры.

VehicleParamsSet

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

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

Параметры

Параметр	Обязательный	Описание
`api_key`	да	Ключ к API
`catalog_code`	да	Код каталога
`family`	да	Семейство (из `ModelsListGet2`)
`model`	да	Код модели (из `ModelsListGet2`)
`ssd`	нет	Идентификатор сессии (пусто при первом вызове)
`param`	нет	Выбранный параметр в виде `код:значение`; несколько — через `;`
`lang`	нет	Язык ответа

Пример

curl "https://api.levam.net/oem/v1/VehicleParamsSet?api_key=КЛЮЧ&catalog_code=3&model=AA3&ssd=&family=Audi+A3"

{
  "client": {
    "mark": "Audi",
    "catalog_code": "3",
    "family": "Audi A3",
    "model": "AA3",
    "ssd": "e5bae1070f765fb2ca054f112b9a74d2",
    "param": "",
    "modification": "",
    "vin": "",
    "frame": "",
    "universal_classifier": "yes"
  },
  "params": {
    "catalog": { "name": "The market", "values": { "BRAZIL": "BRAZIL" } },
    "year_prod": { "name": "Release date", "values": { "2001": "2001", "2002": "2002" } }
  },
  "error": ""
}

Поля ответа

Поле	Описание
`client`	Состояние сессии: каталог, семейство, модель, `ssd`, выбранные параметры, VIN/FRAME (если были)
`client.ssd`	Идентификатор сессии — передавайте в следующие вызовы
`params`	Объект «код параметра → { name, values }». `values` — допустимые значения параметра
`model_image`	Изображение модели (только если существует)
`error`	Информация об ошибке; пустая строка — ошибок нет

Вызывайте VehicleParamsSet повторно, добавляя param=код:значение, пока не сузите выбор, затем переходите к VehicleModificationsGet.

VehicleModificationsGet

Список модификаций, соответствующих выбранным параметрам. Метод бесплатный.

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

Параметры

Параметр	Обязательный	Описание
`api_key`	да	Ключ к API
`ssd`	да	Идентификатор сессии из `VehicleParamsSet`
`lang`	нет	Язык ответа

Пример

curl "https://api.levam.net/oem/v1/VehicleModificationsGet?api_key=КЛЮЧ&ssd=770e1aee96bbf85678ab1426f66af8c6"

{
  "client": { "mark": "Audi", "catalog_code": "3", "family": "Audi A3", "model": "AA3", "ssd": "e5bae1070f765fb2ca054f112b9a74d2" },
  "modifications": [
    {
      "Марка": "Audi",
      "The market": "BRAZIL",
      "Release date": "2001",
      "link": "VElKZGppUnBJY3pHUVRTeFgwVkNpTFFNMVhMdW9v..."
    }
  ],
  "error": ""
}

Поля ответа

Поле	Описание
`client`	Состояние сессии (как в `VehicleParamsSet`)
`modifications[]`	Модификации: названия/значения параметров + поле `link` — код модификации
`modifications[].link`	Код модификации — передаётся в `PartGroupsGet` / `PartsGet`
`error`	Информация об ошибке; пустая строка — ошибок нет

Дальше: группы узлов и детали.