Тип API: Фріміум
В даному API ми не передаємо номер телефону
Щоб звернутися до API auto/info, Вам необхідно виконати GET запит такого виду:
https://developers.ria.com/auto/info?api_key=YOUR_API_KEY&auto_id=id_оголошення
або
curl -i -X GET "https://developers.ria.com/auto/info?api_key=YOUR_API_KEY&auto_id=id_оголошення"
де info — назва методу API, до якого Ви хочете звернутися; API_KEY — API ключ; auto_id — номер оголошення за яким потрібна інформація
Приклад
Припустимо, Вам потрібна інформація по id оголошення 35453319.
Цей запит матиме такий вигляд:
https://developers.ria.com/auto/info?api_key=YOUR_API_KEY&auto_id=35453319
або
curl -i -X GET "https://developers.ria.com/auto/info?api_key=YOUR_API_KEY&auto_id=35453319"
В разі успішного виконання запиту результат буде зі статусом 200 OK.
В даному API ми не передаємо номер телефону, а саме параметр userPhoneData в будь-якому випадку буде виглядати так:
"userPhoneData": {
"phone": "(xxx) xxx xx xx",
"phoneId": "xxxxxxxxx"
Приклад успішної відповіді:
{
"markId": 84,
"infoBarText": "",
"title": "Volkswagen Passat Alltrack",
"videoMessageID": "",
"dontComment": 1,
"updateDate": "2023-10-24 20:13:27",
"expireDate": "2023-11-23 15:02:33",
"UAH": 771936,
"exchangePossible": false,
"moderatedAbroad": false,
"isLeasing": 0,
"cityLocative": "Вінниці",
"linkToView": "/auto_volkswagen_passat_alltrack_35453319.html",
"technicalChecked": true,
"EUR": 18814,
"modelName": "Passat Alltrack",
"plateNumberData": {
"text": "AB 6398 KH"
},
"hasWebP": 0,
"soldDate": "",
"VIN": "WVWZZZ3CZHE115339",
"USD": 20400,
"levelData": {
"expireDate": "",
"hotType": "",
"label": 0,
"level": 0
},
"optionStyles": [ ],
"photoData": {
"all": [
520885501,
520885505,
520885502,
520885499,
520885526,
520885531,
520885535,
520885537,
520885545,
520885549,
520885559,
520885564,
520885572,
520885574,
520885575,
520885580,
520885592,
520885603,
520885605,
520885615,
520885614,
520885621,
520885625,
520885631,
520885645,
520885660,
520885661,
520885666,
520885695,
520885689,
520885694,
520885706,
520885713,
520885727,
520885728,
520885732,
520885735
],
"count": 37,
"seoLinkB": "https://cdn1.riastatic.com/photosnew/auto/photo/volkswagen_passat-alltrack__520885706b.jpg",
"seoLinkF": "https://cdn1.riastatic.com/photosnew/auto/photo/volkswagen_passat-alltrack__520885706f.jpg",
"seoLinkM": "https://cdn1.riastatic.com/photosnew/auto/photo/volkswagen_passat-alltrack__520885706m.jpg",
"seoLinkSX": "https://cdn1.riastatic.com/photosnew/auto/photo/volkswagen_passat-alltrack__520885706sx.jpg"
},
"locationCityName": "Вінниця",
"userPhoneData": {
"phone": "(xxx) xxx xx xx",
"phoneId": "xxxxxxxxx"
},
"subCategoryName": "Універсал",
"markNameEng": "volkswagen",
"modelId": 2805,
"exchangeTypeId": 0,
"userBlocked": [ ],
"userId": 13442883,
"stateData": {
"cityId": 1,
"linkToCatalog": "/city/vinnica/",
"name": "Вінниця",
"regionName": "Вінницька",
"regionNameEng": "vinnica",
"stateId": 1,
"title": "Пошук оголошень по місту Вінниця"
},
"dealer": {
"id": 0,
"link": "",
"logo": "",
"name": "",
"packageId": 0,
"type": "",
"typeId": 0,
"verified": false
},
"markName": "Volkswagen",
"realtyExchange": false,
"plateNumber": "AB 6398 KH",
"autoData": {
"active": true,
"autoId": 35453319,
"bodyId": 2,
"categoryId": 1,
"categoryNameEng": "legkovie",
"custom": 0,
"description": "авто в гарному збереженому стані, тільки превезене з Швейцарії з рідним пробігом, обслуговування проходило на офіційному сервісі, е сервісна книжка з повною історією\nАвто почало використовуватись 26,01,2017р\nБез підкрасів, в гарному технічному стані....",
"driveId": 1,
"driveName": "Повний",
"fromArchive": false,
"fuelId": 2,
"fuelName": "Дизель, 2 л.",
"fuelNameEng": "dizel",
"gearBoxId": 4,
"gearboxName": "Робот",
"isSold": false,
"mainCurrency": "USD",
"onModeration": false,
"race": "272 тис. км",
"raceInt": 272,
"statusId": 0,
"subCategoryNameEng": "universal",
"vat": false,
"version": "",
"withVideo": false,
"withVideoMessages": false,
"year": 2016
},
"modelNameEng": "passat-alltrack",
"canSetSpecificPhoneToAdvert": false,
"userHideADSStatus": false,
"partnerId": 0,
"auctionPossible": false,
"withInfoBar": false,
"haveInfotechReport": true,
"firstTime": true,
"badges": [ ],
"autoInfoBar": {
"abroad": false,
"confiscatedCar": false,
"custom": false,
"damage": false,
"onRepairParts": false,
"underCredit": false
},
"isAutoAddedByPartner": false,
"addDate": "2023-10-24 15:02:33",
"agreeShowVIN": 1,
"sendComments": 0,
"secureKey": "b365af60712a0b608dc5ff43e43e3042",
"videoMessages": { },
"exchangeType": "Будь-який",
"chipsCount": 0,
"color": {
"eng": "black",
"hex": "#000000",
"name": "Чорний"
},
"checkedVin": {
"isShow": false,
"orderId": 0,
"vin": "WVWZZZ3CZHE115339"
}
}
Параметри:
Параметр | Опис |
---|---|
userId | id користувача |
locationCityName | Місто |
auctionPossible | Торг |
exchangePossible | Обмін |
realtyExchange | Обмін на нерухомість |
exchangeType | Тип обміна |
exchangeTypeId | Ідентифікатор типу обміну |
addDate | Дата і час додавання |
updateDate | Дата і час оновлення |
expireDate | Дата і час закінчення |
userHideADSStatus | Користувач приховав статус |
userPhoneData | Телефон користувача (! ми не передаємо дану інформацію) |
USD | Вартість у доларах США |
UAH | Вартість у гривнях |
EUR | Вартість у євро |
levelData | Рівень топа |
label | Мітка |
hotType | Мітка "TOP" або "Терміново" |
expireDate | Дата і час закінчення мітки "TOP" "Терміново" |
autoData | Характеристики автомобіля |
description | Опис |
year | Рік випуску |
autoId | id оголошення |
withVideo | Наявність відео |
race | Пробіг |
fuelName | Тип палива |
gearboxName | Тип приводу |
isSold | Цей параметр показує чи машину продано чи ні |
mainCurrency | Основна валюта |
categoryId | Тип транспорту |
markName | Марка автомобіля |
markId | id марки автомобіля |
modelName | Модель автомобіля |
modelId | id Моделі автомобіля |
photoData | Фото |
count | Кількість фотографій |
seoLinkM | Посилання на оголошення |
title | Назва |
stateData | Місто |
regionName | Область |
stateId | id Міста |
checkedVin | Перевірка VIN-коду |
isShow | Відображати VIN-код |
linkToReport | Обмеження |
checkDate | VIN-код перевірено |
isLeasing | Лізинг |
withInfoBar | Інформаційна панель |