---
title: Подбор модификации по параметрам
description: Методы VehicleParamsSet и VehicleModificationsGet — уточнение модификации автомобиля и механизм SSD.
---

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

Если 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` | нет | Язык ответа |

### Пример

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

```json
{
  "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` | нет | Язык ответа |

### Пример

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

```json
{
  "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` | Информация об ошибке; пустая строка — ошибок нет |

Дальше: [группы узлов и детали](/docs/ru/parts).