¶ Опції для роботи з лістингами (публікацією оголошень) V2
¶ Отримання опцій по id оголошення
GET
Запит
https://developers.ria.com/auto/used/autos/advertisementID/optionsV2?user_id=ВАШ_ID&api_key=YOUR_API_KEY
Приклад відповіді:
Дивись!
[
{
"optionId": 10,
"optionValue": 1
},
{
# "optionId": 12,
"optionValue": 1
},
{
"optionId": 15,
"optionValue": 1
},
...
]
¶ Додавання опцій вперше
Збереження опцій по айді оголошення, якщо до цього в оголошення не було збережено опцій
POST
¶ Запит:
https://developers.ria.com/auto/used/autos/advertisementID/optionsV2?user_id=ВАШ_ID&api_key=YOUR_API_KEY
¶ Body
[
{
"optionId": 10,
"optionValue": 1
},
{
"optionId": 12,
"optionValue": 1
},
...
]
Success Response
201 Created
Bad response
{ "code": "invalid_type", "expected": "number", "received": "undefined", "path": [ 7, "optionId" ], "message": "Required" }, { "code": "unrecognized_keys", "keys": [ "wrongOptionName" ], "path": [ 7 ], "message": "Unrecognized key(s) in object: 'wrongOptionName'" } ]
¶ Редагування опцій
Оновлення даних про додаткові опції по id оголошення
Для редагування опцій не потрібно їх видаляти, Ви можете при редагуванні одразу вказати нові опції які потрібні для відображення в оголошенні
PUT
¶ Request
https://developers.ria.com/auto/used/autos/advertisementID/optionsV2?user_id=ВАШ_ID&api_key=YOUR_API_KEY
¶ Body
[
{
"optionId": 10,
"optionValue": 1
},
{
"optionId": 12,
"optionValue": 1
},
...
]
Success Response
200 OK
Bad response
[ { "code": "invalid_type", "expected": "number", "received": "undefined", "path": [ 7, "optionId" ], "message": "Required" }, { "code": "unrecognized_keys", "keys": [ "wrongOptionName" ], "path": [ 7 ], "message": "Unrecognized key(s) in object: 'wrongOptionName'" } ]
¶ Детальніше про збереження/редагування опцій
typeId=1 - тип опції: чекбокс
typeId=2 - тип опції: випадаючий список
parentId - це id опції з typeId=2, з словника опцій
При заповненні опції з typeId=1, сетапити optionValue - 1
Наприклад, хочемо зберегти "Система управління дальнім світлом" та "Шноркель"
[{ optionId: 33, optionValue: 1 }, { optionId: 124, optionValue: 1 }]
При заповненні опції з typeId=2, сетапимо optionValue з словника значень опцій
Наприклад, хочемо зберегти "Кондиціонер" - "Клімат-контроль 1-зонний" та "Запасне колесо" - "Повнорозмірне"
[{ optionId: 135, optionValue: 31 }, { optionId: 138, optionValue: 47 }]
Всі опції для збереження/редагування, відправляємо разом, не залежно від typeId;
¶ Видалення опцій оголошення
DELETE
Видалення опцій оголошення
¶ Request
https://developers.ria.com/auto/used/autos/advertisementID/optionsV2?user_id=ВАШ_ID&api_key=YOUR_API_KEY
Success Response
204 No content
¶ Перелік опцій
| optionId | optionTypeId | optionName |
|---|---|---|
| 1 | 1 | Шкіряний салон |
| 2 | 1 | Люк |
| 3 | 1 | Центральний замок |
| 4 | 1 | Бортовий комп'ютер |
| 5 | 1 | Парктронік передній |
| 6 | 1 | Водія |
| 7 | 1 | Антиблокувальна система (ABS) |
| 8 | 1 | Газобалонне обладнання (ГБО) |
| 9 | 1 | Датчик дощу |
| 10 | 1 | Акустика |
| 11 | 1 | Сигналізація |
| 12 | 1 | Навігаційна система |
| 13 | 1 | Датчик світла |
| 14 | 1 | Гідроборт |
| 15 | 1 | Омивач фар |
| 16 | 1 | Посилена підвіска |
| 17 | 1 | Підігрів дзеркал |
| 18 | 1 | Система стабілізації (ESP) |
| 19 | 1 | Тюнінг |
| 20 | 1 | Гаражне зберігання |
| 21 | 1 | Сервісна книжка |
| 22 | 1 | Тоновані вікна |
| 23 | 1 | Перший власник |
| 24 | 1 | Перша реєстрація |
| 25 | 1 | Ручне керування для людей з інвалідністю |
| 26 | 1 | Броньований кузов |
| 27 | 1 | Обігрів керма |
| 28 | 1 | Запуск двигуна з кнопки |
| 29 | 1 | Пандус для людей з інвалідністю |
| 30 | 1 | Денні ходові вогні |
| 31 | 1 | Протитуманні фари |
| 32 | 1 | Система адаптивного освітлення |
| 33 | 1 | Система управління дальнім світлом |
| 34 | 1 | Аудіопідготовка |
| 35 | 1 | Мультимедіа система з LCD-екраном |
| 36 | 1 | AUX |
| 37 | 1 | Bluetooth |
| 38 | 1 | USB |
| 39 | 1 | Система мультимедіа для задніх пасажирів |
| 40 | 1 | Голосове керування |
| 41 | 1 | Android Auto |
| 42 | 1 | CarPlay |
| 43 | 1 | Бездротова зарядка для смартфону |
| 44 | 1 | Складане заднє сидіння |
| 45 | 1 | Функція складання спинки сидіння пасажира |
| 46 | 1 | Третій задній підголівник |
| 47 | 1 | Третій ряд сидінь |
| 48 | 1 | Довга база |
| 49 | 1 | Кузов MAXI |
| 50 | 1 | Складний столик на спинках передніх сидінь |
| 51 | 1 | Оздоблення керма шкірою |
| 52 | 1 | Оздоблення шкірою важеля КПП |
| 53 | 1 | Панорамний дах / Лобове скло |
| 54 | 1 | Оздоблення стелі чорного кольору |
| 55 | 1 | Передній центральний підлокітник |
| 56 | 1 | Сонцезахисні шторки в задніх дверях |
| 57 | 1 | Декоративне підсвічування салону |
| 58 | 1 | Декоративні накладки на педалі |
| 59 | 1 | Накладки на пороги |
| 60 | 1 | Розетка 220V |
| 61 | 1 | Розетка 12V |
| 62 | 1 | Захист картера |
| 63 | 1 | Захист коробки |
| 64 | 1 | Фаркоп |
| 65 | 1 | Система доступу без ключа |
| 66 | 1 | Система «старт-стоп» |
| 67 | 1 | Проекційний дисплей |
| 68 | 1 | Електрорегулювання керма |
| 69 | 1 | Кермо з пам'яттю положення |
| 70 | 1 | Мультифункціональне кермо |
| 71 | 1 | Підрульові пелюстки перемикання передач |
| 72 | 1 | Сидіння з масажем |
| 73 | 1 | Відкриття багажника без допомоги рук |
| 74 | 1 | Електропривід дзеркал |
| 75 | 1 | Електроскладання дзеркал |
| 76 | 1 | Бардачок з охолодженням |
| 77 | 1 | Регульований педальний вузол |
| 78 | 1 | Доводчик дверей |
| 79 | 1 | Підкурювач і попільничка |
| 80 | 1 | Обігрів лобового скла |
| 81 | 1 | Холодильник |
| 82 | 1 | Адаптивний круїз |
| 83 | 1 | Пневмопідвіска |
| 84 | 1 | Електронна приладова панель |
| 85 | 1 | Дистанційний запуск двигуна |
| 86 | 1 | Автономний обігрівач webasto |
| 87 | 1 | Швидка зарядка CHAdeMO |
| 88 | 1 | Парктронік задній |
| 89 | 1 | Система автоматичного паркування |
| 90 | 1 | Передня камера |
| 91 | 1 | Задня камера |
| 92 | 1 | Камера 360 |
| 93 | 1 | Імобілайзер |
| 94 | 1 | Круїз контроль |
| 95 | 1 | Антипробуксовочна система (ASR) |
| 96 | 1 | Стабілізація рульового управління (VSM) |
| 97 | 1 | Розподіл гальмівних зусиль (BAS, EBD) |
| 98 | 1 | Допомога при старті в гору |
| 99 | 1 | Вибір режиму руху |
| 100 | 1 | Допомога при спуску |
| 101 | 1 | Запобігання зіткнення |
| 102 | 1 | Контроль сліпих зон |
| 103 | 1 | Контроль за смугою руху |
| 104 | 1 | Датчик втоми водія |
| 105 | 1 | Розпізнавання дорожніх знаків |
| 106 | 1 | Нічне бачення |
| 107 | 1 | Датчик тиску в шинах |
| 108 | 1 | Система кріплення IsoFix |
| 109 | 1 | Блокування замків задніх дверей |
| 110 | 1 | Датчик проникнення в салон (датчик об`єму) |
| 111 | 1 | Пасажира |
| 112 | 1 | Бічні передні |
| 113 | 1 | Бічні задні |
| 114 | 1 | Віконні (шторки) |
| 115 | 1 | Колін водія |
| 116 | 1 | Електропривід кришки багажника |
| 117 | 1 | Авто в кредиті |
| 118 | 1 | Сонцезахисна шторка на задньому склі |
| 119 | 1 | Керування жестами |
| 120 | 1 | MirrorLink |
| 121 | 1 | Центральна подушка між водієм та пасажиром |
| 122 | 1 | Багажник на дах |
| 123 | 1 | Лебідка |
| 124 | 1 | Шноркель |
| 125 | 1 | Ліфтована підвіска |
| 126 | 1 | Тепловий насос |
| 128 | 2 | Матеріали салону |
| 129 | 2 | Колір салону |
| 130 | 2 | Регулювання сидінь салону по висоті |
| 131 | 2 | Вентиляція сидінь |
| 132 | 2 | Підігрів сидінь |
| 133 | 2 | Пам'ять положення сидіння |
| 134 | 2 | Електросклопідйомники |
| 135 | 2 | Кондиціонер |
| 136 | 2 | Підсилювач керма |
| 137 | 2 | Регулювання керма |
| 138 | 2 | Запасне колесо |
| 139 | 2 | Фари |
¶ Словник значень опцій
| optionValue | parentId | optionValueName |
|---|---|---|
| 1 | 128 | Тканина |
| 2 | 128 | Шкіра |
| 3 | 128 | Велюр |
| 4 | 128 | Комбінований |
| 5 | 128 | Штучна шкіра |
| 6 | 128 | Алькантара |
| 8 | 129 | Світлий |
| 9 | 129 | Темний |
| 10 | 129 | Коричневий |
| 11 | 130 | Ручне регулювання сидіння водія |
| 12 | 130 | Ручне регулювання передніх сидінь |
| 13 | 130 | Електрорегулювання сидіння водія |
| 14 | 130 | Електрорегулювання передніх сидінь |
| 15 | 130 | Електрорегулювання передніх та задніх сидінь |
| 18 | 131 | Передні сидіння |
| 19 | 131 | Передні та задні сидіння |
| 21 | 132 | Передні сидіння |
| 22 | 132 | Передні та задні сидіння |
| 24 | 133 | Сидіння водія |
| 25 | 133 | Передні сидіння |
| 26 | 133 | Передні та задні сидіння |
| 27 | 134 | Передні |
| 28 | 134 | Передні та задні |
| 30 | 135 | Кондиціонер |
| 31 | 135 | Клімат-контроль 1-зонний |
| 32 | 135 | Клімат-контроль 2-зонний |
| 33 | 135 | Клімат-контроль багатозонний |
| 37 | 136 | Гідро |
| 38 | 136 | Електро |
| 43 | 137 | По висоті |
| 44 | 137 | По висоті та по вильоту |
| 46 | 138 | Повнорозмірне |
| 47 | 138 | Докатка |
| 49 | 139 | Ксенонові/Біксенонові |
| 50 | 139 | Лазерні |
| 51 | 139 | Світлодіодні |
| 52 | 139 | Матричні |
| 53 | 139 | Галогенні |