Тип API: Платний
Інформація по номеру авто, VIN коду, id оголошення буде доступна лише в тому випадку, якщо дане авто розміщувалось на сайті.
Важливо! Запити робляться методом POST. Обов’язкові параметри в шляху: user_id та api_key.
Для виконання запитів користувачі можуть використовувати Postman (інструкція) чи будь-яке аналогічне ПЗ.
Повертає інформацію про авто згідно його VIN-коду, держ.номеру чи id.
URL
POST https://developers.ria.com/auto/params/by/vin-code/?user_id=YOUR_USER_ID&api_key=YOUR_API_KEY
де YOUR_USER_ID - ідентифікатор користувача, YOUR_API_KEY - персональний ключ доступу користувача.
Headers
| Header name | Description | Required | Values |
|---|---|---|---|
| Content-Type | Формат даних про авто, що передаються | required | application/json |
POST Body
| Element | Description | Type | Required |
|---|---|---|---|
| langId | Ідентифікатор мови | integer | Required |
| period | Період | integer | Required |
| params | Collection of objects | Required | |
| - omniId | ідентифікатор VIN-коду/держ.номеру/оголошення | string | Required |
Зразок запиту
POST https://developers.ria.com/auto/params/by/vin-code/?user_id=12246211&api_key=YOUR_API_KEY
Content-type: application/json
{
"langId": 4,
"period": 365,
"params": {
"omniId": "TMBGP21U432674944"
}
}
Відповідь
| Параметер | Опис | Тип |
|---|---|---|
| chipsData | Collection of objects | |
| - chips | Array of objects | |
| - - entity | Сутність (тип транспорту/марка/модель/тип кузову/тип палива/об'єм двигуна/коробка передач/тип приводу/колір/область/пробіг/покоління/модифікація/рік) | string |
| - - id | Ідентифікатор | string |
| - - name | Назва сутності | string |
| - link | Collection of objects | |
| - - text | Текст | string |
| - - URL | Посилання | string |
| noticeData | Collection of objects | |
| - linkHref | string | |
| - linkText | string | |
| - noticeString | string | |
| - noticeType | string | |
| searchType | Тип пошуку | string |
Зразок відповіді
{
"chipsData": {
"chips": [
{
"entity": "categoryId",
"id": "categoryId_0",
"name": "Легкові"
},
{
"entity": "brandId",
"id": "brandId_0",
"name": "Skoda"
},
{
"entity": "modelId",
"id": "modelId_0",
"name": "Octavia"
},
{
"entity": "bodyId",
"id": "bodyId_0",
"name": "Універсал"
},
{
"entity": "fuelId",
"id": "fuelId_0",
"name": "Дизель"
},
{
"entity": "engineVolume",
"id": "engineVolume_0",
"name": "Об'єм двигуна від 1.9 до 1.9 л"
},
{
"entity": "gearBoxId",
"id": "gearBoxId_0",
"name": "Ручна / Механіка"
},
{
"entity": "driveId",
"id": "driveId_0",
"name": "Передній"
},
{
"entity": "colorId",
"id": "colorId_0",
"name": "Зелений"
},
{
"entity": "stateId",
"id": "stateId_0",
"name": "Вінницька"
},
{
"entity": "mileage",
"id": "mileage_0",
"name": "Пробіг від 313 до 313 тис.км"
},
{
"entity": "modificationId",
"id": "modificationId_0",
"name": "1.9 TDI MT (110 к.с.)"
},
{
"entity": "generationId",
"id": "generationId_0",
"name": "I покоління/Tour (FL)"
},
{
"entity": "year",
"id": "year_0",
"name": "2002 - 2002 рр."
}
],
"link": {
"text": "Переглянути пропозиції",
"url": "https://auto.ria.com/uk/search/?indexName=auto,order_auto,newauto_search&page=0&size=20&body.id[0]=2&brand.id[0]=70&categories.main.id=1&color.id[0]=7&drive.id[0]=2&engine.gte=1.9&engine.lte=1.9&fuel.id[0]=2&gearbox.id[0]=1&generation.id%5B0%5D%5B0%5D=8075&model.id[0]=652&modification.id%5B0%5D%5B0%5D%5B0%5D=143614®ion.id[0]=1&year%5B0%5D.gte=2002&year%5B0%5D.lte=2002"
}
},
"noticeData": [
{
"linkHref": "",
"linkText": "",
"noticeString": "Знайдено Skoda Octavia 2002 за VIN-номером TMBGP21U432674944",
"noticeType": "success"
}
],
"searchType": "VIN"
}