Vehicle selection by parameters

When the VIN is unknown, the modification is selected by parameters: pick a catalog and model, then refine parameters (production year, market, body…) until you get a list of modifications with link codes.

The SSD mechanism

ssd (Server Side Data) is a server-side selection session identifier. The first VehicleParamsSet call without ssd creates a new session and returns its identifier in client.ssd; all subsequent calls of the chain must pass this ssd. The session stores the selected catalog, model, and accumulated parameters.

VehicleParamsSet

Narrowing down the modification of the selected model. Free method.

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

Parameters

Parameter	Required	Description
`api_key`	yes	API key
`catalog_code`	yes	Catalog code
`family`	yes	Family (from `ModelsListGet2`)
`model`	yes	Model code (from `ModelsListGet2`)
`ssd`	no	Session identifier (empty on the first call)
`param`	no	Selected parameter as `code:value`; multiple — separated by `;`
`lang`	no	Response language

Example

curl "https://api.levam.net/oem/v1/VehicleParamsSet?api_key=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": ""
}

Response fields

Field	Description
`client`	Session state: catalog, family, model, `ssd`, selected parameters, VIN/FRAME (if any)
`client.ssd`	Session identifier — pass it to subsequent calls
`params`	"Parameter code → { name, values }" object. `values` — allowed parameter values
`model_image`	Model image (only when it exists)
`error`	Error information; an empty string means no error

Call VehicleParamsSet repeatedly, adding param=code:value, until the choice is narrow enough, then proceed to VehicleModificationsGet.

VehicleModificationsGet

The list of modifications matching the selected parameters. Free method.

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

Parameters

Parameter	Required	Description
`api_key`	yes	API key
`ssd`	yes	Session identifier from `VehicleParamsSet`
`lang`	no	Response language

Example

curl "https://api.levam.net/oem/v1/VehicleModificationsGet?api_key=KEY&ssd=770e1aee96bbf85678ab1426f66af8c6"

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

Response fields

Field	Description
`client`	Session state (as in `VehicleParamsSet`)
`modifications[]`	Modifications: parameter names/values plus the `link` field — the modification code
`modifications[].link`	Modification code — passed to `PartGroupsGet` / `PartsGet`
`error`	Error information; an empty string means no error

Next: unit groups and parts.