├── .gitignore ├── AUTO_RIA_API └── README.md ├── DOM_RIA_API └── README.md ├── LICENSE ├── README.md └── RIA_com_API └── README.md /.gitignore: -------------------------------------------------------------------------------- 1 | # Logs 2 | logs 3 | *.log 4 | 5 | # Runtime data 6 | pids 7 | *.pid 8 | *.seed 9 | 10 | # Directory for instrumented libs generated by jscoverage/JSCover 11 | lib-cov 12 | 13 | # Coverage directory used by tools like istanbul 14 | coverage 15 | 16 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files) 17 | .grunt 18 | 19 | # Compiled binary addons (http://nodejs.org/api/addons.html) 20 | build/Release 21 | 22 | # Dependency directory 23 | # Commenting this out is preferred by some people, see 24 | # https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git- 25 | node_modules 26 | 27 | # Users Environment Variables 28 | .lock-wscript 29 | 30 | .idea 31 | -------------------------------------------------------------------------------- /DOM_RIA_API/README.md: -------------------------------------------------------------------------------- 1 | # DOM.RIA 2 | 3 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 4 | 5 | Для получения **API_KEY** нужно зарегестрироваться на [Developers.ria.com](https://developers.ria.com/) 6 | 7 | ## Параметры для работы с DOM.RIA API 8 | 9 | ### Продажа квартир/комнат 10 | 11 | | Название | Параметр в строке запроса | Тип данных | 12 | |:--------------------|:--------------------------|:------------:| 13 | |Тип объекта | category| `Number` | 14 | |Тип недвижимости |realty_type | `Number` | 15 | |Тип операции | operation_type| `Number` | 16 | |Область | state_id| `Number` | 17 | |Город | city_id| `Number[]` | 18 | |Район | district_id|`Number[]` | 19 | |Тип стен| characteristic[118] |`Number[]` | 20 | |Количество комнат |characteristic[209][from] - characteristic[209][to] | `Number[]` | 21 | |Общая площадь |characteristic[214][from] - characteristic[214][to] |`Number[]` | 22 | |Жилая площадь |characteristic[216][from] - characteristic[216][to] |`Number[]` | 23 | |Кухня |characteristic[218][from] - characteristic[218][to] |`Number[]` | 24 | |Этаж |characteristic[227][from] - characteristic[227][to] | `Number[]` | 25 | |Этажность |characteristic[228][from] - characteristic[228][to] | `Number[]` | 26 | |Кухня студия |characteristic[1501] | `Number` | 27 | |Пентхаус |characteristic[1504] |`Number` | 28 | |Многоуровневая|characteristic[1502] |`Number` | 29 | |С мансардой |characteristic[1503] |`Number` | 30 | |Год постройки |characteristic[443] |`Number` | 31 | |Коммунальные платежи в зимний период |characteristic[1607][from] - characteristic[1607][to] |`Number[]` | 32 | |Коммунальные платежи в летний период |characteristic[1608][from] - characteristic[1608][to] | `Number[]`| 33 | |Цена |characteristic[234][from] - characteristic[234][to] | `Number[]`| 34 | |Цена за (объект / квадратный метр) |characteristic[247] |`Number` | 35 | |Цена договорная |characteristic[1011] |`Number` | 36 | |Стартовая цена |characteristic[1464] |`Number` | 37 | |Тип валюты |characteristic[246] |`Number` | 38 | |Возможен обмен |characteristic[265] | `Number`| 39 | |Возможен торг |characteristic[273] | `Number`| 40 | |Тип предложения |characteristic[1437] |`Number` | 41 | |Возможна расстрочка/кредит |characteristic[274] | `Number`| 42 | |Только с картой |with_map |`Number` | 43 | |Только с видео | with_video |`Number` | 44 | |Только с фото |with_photo |`Number` | 45 | |Только с фото (более 3 фото)| photos_count_from| `Number`| 46 | |Только ТОП| urgent_only|`Number` | 47 | |Залоговое имущество | banks_only|`Number` | 48 | |Вторичное жилье |secondary |`Number` | 49 | |Первичное жилье | newbuildings| `Number`| 50 | |Не показывать мои объявления | exclude_my| `Number`| 51 | |Не показывать объявления от агентств|exclude_agencies |`Number` | 52 | |Дата подачи |date_from - date_to |`Number` | 53 | |Страница|page | | 54 | 55 | ### Аренда квартир/комнат 56 | 57 | | Название | Параметр в строке запроса | Тип данных | 58 | |:--------------------|:--------------------------|:------------:| 59 | |Тип объекта | category| `Number` | 60 | |Тип недвижимости |realty_type | `Number` | 61 | |Тип операции | operation_type| `Number` | 62 | |Область | state_id|`Number` | 63 | |Город | city_id|`Number[]` | 64 | |Район | district_id|`Number[]` | 65 | |Тип стен| characteristic[118] | `Number[]`| 66 | |Количество комнат |characteristic[209][from] - characteristic[209][to] |`Number[]` | 67 | |Общая площадь |characteristic[214][from] - characteristic[214][to] |`Number[]` | 68 | |Жилая площадь |characteristic[216][from] - characteristic[216][to] |`Number[]` | 69 | |Кухня |characteristic[218][from] - characteristic[218][to] |`Number[]` | 70 | |Этаж |characteristic[227][from] - characteristic[227][to] | `Number[]`| 71 | |Этажность |characteristic[228][from] - characteristic[228][to] |`Number[]` | 72 | |С джакузи| characteristic[1481]|`Number` | 73 | |С отоплением| characteristic[1478]|`Number` | 74 | |С мебелью |characteristic[1480] |`Number` | 75 | |С ремонтом |characteristic[1479] | `Number`| 76 | |Дополнительные платежи |characteristic[254] |`Number` | 77 | |С подсилением |characteristic[1500] |`Number` | 78 | |Совместная аренда |characteristic[1596] |`Number` | 79 | |Коммунальные платежи в зимний период |characteristic[1609][from] - characteristic[1609][to] | `Number[]`| 80 | |Коммунальные платежи в летний период |characteristic[1610][from] - characteristic[1610][to] | `Number[]`| 81 | |Цена/месяц |characteristic[235][from] - characteristic[235][to] | `Number[]`| 82 | |Цена договорная |characteristic[1011] | `Number`| 83 | |Детализация **(Аренда посуточно)** |characteristic[1399] |`Number` | 84 | |Кухня студия **(Аренда посуточно)**|characteristic[1501] |`Number` | 85 | |На выходные **(Аренда посуточно)** |characteristic[1477] | `Number`| 86 | |На празники **(Аренда посуточно)** |characteristic[1498] | `Number`| 87 | |На новый год **(Аренда посуточно)** |characteristic[1499] |`Number` | 88 | |Цена/сутки **(Аренда посуточно)** |characteristic[237][from] - characteristic[237][to] | `Number[]`| 89 | |Цена/час **(Аренда посуточно)** |characteristic[238][from] - characteristic[238][to] |`Number[]` | 90 | |Цена/неделю |characteristic[279][from] - characteristic[279][to] |`Number[]` | 91 | |Тип валюты |characteristic[246] | `Number`| 92 | |Тип предложения |characteristic[1437] | `Number`| 93 | |Только с картой |with_map |`Number` | 94 | |Только с видео | with_video | `Number`| 95 | |Только с фото |with_photo | `Number`| 96 | |Только с фото (более 3 фото)| photos_count_from|`Number` | 97 | |Только ТОП| urgent_only|`Number` | 98 | |Залоговое имущество | banks_only| `Number`| 99 | |Вторичное жилье |secondary | `Number`| 100 | |Первичное жилье | newbuildings| `Number`| 101 | |Не показывать мои объявления | exclude_my| `Number`| 102 | |Не показывать объявления от агентств|exclude_agencies |`Number` | 103 | |Дата подачи |date_from - date_to |`Number` | 104 | |Страница|page |`Number` | 105 | 106 | 107 | ### Продажа домов 108 | 109 | | Название | Параметр в строке запроса | Тип данных | 110 | |:--------------------|:--------------------------|:------------:| 111 | |Тип объекта | category| `Number` | 112 | |Тип недвижимости |realty_type | `Number` | 113 | |Тип операции | operation_type| `Number` | 114 | |Область | state_id| `Number`| 115 | |Город | city_id|`Number[]` | 116 | |Район | district_id| `Number[]`| 117 | |Тип стен | characteristic[149]|`Number` | 118 | |Количество комнат |characteristic[209][from] - characteristic[209][to] | `Number[]`| 119 | |Общая площадь |characteristic[215][from] - characteristic[215][to] |`Number[]` | 120 | |Жилая площадь |characteristic[216][from] - characteristic[216][to] |`Number[]` | 121 | |Кухня |characteristic[218][from] - characteristic[218][to] | `Number[]`| 122 | |Участок |characteristic[219][from] - characteristic[219][to] | `Number[]`| 123 | |Единица измерения площади участка |characteristic[226] | `Number[]`| 124 | |C беседкой |characteristic[1492] |`Number` | 125 | |С верандой |characteristic[1491] |`Number` | 126 | |С подвалом |characteristic[1490] | `Number`| 127 | |С балконом |characteristic[1489] |`Number` | 128 | |С камином |characteristic[1488] |`Number` | 129 | |С садом |characteristic[1487] | `Number`| 130 | |С баней/сауной |characteristic[1486] |`Number` | 131 | |С террасой |characteristic[1485] |`Number` | 132 | |С гаражом |characteristic[1484] | `Number`| 133 | |С участком |characteristic[1505] |`Number` | 134 | |С мансардою |characteristic[1482] |`Number` | 135 | |С мебелью |characteristic[1480] | `Number`| 136 | |С ремонтом |characteristic[1479] |`Number` | 137 | |С отоплением |characteristic[1478] | `Number`| 138 | |Мансардный этаж |characteristic[230] | `Number`| 139 | |Подвальный / цокольный этаж |characteristic[231] | `Number`| 140 | |У озера **Дача** |characteristic[1494] |`Number` | 141 | |У реки **Дача** |characteristic[1493] | `Number`| 142 | |Жилых этажей |characteristic[229][from] - characteristic[229][to] | `Number[]`| 143 | |Год постройки |characteristic[443] | `Number`| 144 | |Цена |characteristic[234][from] -characteristic[234][to] |`Number[]` | 145 | |Цена договорная |characteristic[1011]|`Number` | 146 | |Стартовая цена |characteristic[1464] |`Number` | 147 | |Тип валюты |characteristic[242] | `Number`| 148 | |Возможен обмен |characteristic[265] | `Number`| 149 | |Возможен торг | characteristic[273]| `Number`| 150 | |Тип предложения |characteristic[1437] | `Number`| 151 | |Возможна расстрочка/кредит |characteristic[274] |`Number` | 152 | |Только с картой |with_map |`Number` | 153 | |Только с видео | with_video | `Number`| 154 | |Только с фото |with_photo |`Number` | 155 | |Только с фото (более 3 фото)| photos_count_from|`Number` | 156 | |Только ТОП| urgent_only| `Number`| 157 | |Залоговое имущество | banks_only|`Number` | 158 | |Вторичное жилье |secondary | `Number`| 159 | |Первичное жилье | newbuildings| `Number`| 160 | |Не показывать мои объявления | exclude_my|`Number` | 161 | |Не показывать объявления от агентств|exclude_agencies |`Number` | 162 | |Дата подачи |date_from - date_to |`Number` | 163 | |Страница|page |`Number` | 164 | 165 | 166 | ### Аренда домов 167 | 168 | | Название | Параметр в строке запроса | Тип данных | 169 | |:--------------------|:--------------------------|:------------:| 170 | |Тип объекта | category| `Number` | 171 | |Тип недвижимости |realty_type | `Number` | 172 | |Тип операции | operation_type| `Number` | 173 | |Область | state_id| `Number`| 174 | |Город | city_id| `Number[]`| 175 | |Район | district_id|`Number[]` | 176 | |Тип стен | characteristic[149]| `Number`| 177 | |Количество комнат |characteristic[209][from] - characteristic[209][to] |`Number[]` | 178 | |Общая площадь |characteristic[215][from] - characteristic[215][to] |`Number[]` | 179 | |Жилая площадь |characteristic[216][from] - characteristic[216][to] |`Number[]` | 180 | |С балконом |characteristic[1489] |`Number` | 181 | |С камином |characteristic[1488] | `Number`| 182 | |С бассейном |characteristic[1483] | `Number`| 183 | |С баней/сауной |characteristic[1486] |`Number` | 184 | |С гаражом |characteristic[1484] |`Number` | 185 | |С мебелью |characteristic[1480] | `Number`| 186 | |С ремонтом |characteristic[1479] | `Number`| 187 | |Мансардный этаж |characteristic[230] | `Number`| 188 | |Подвальный / цокольный этаж |characteristic[231] | `Number`| 189 | |Цена/месяц |characteristic[235][from] - characteristic[235][to] |`Number[]` | 190 | |Цена договорная |characteristic[1011] |`Number` | 191 | |Дополнительные платежи |characteristic[254] | `Number`| 192 | |Детализация **(Аренда посуточно)** |characteristic[1399] |`Number` | 193 | |Спальных мест от **(Аренда посуточно)** |characteristic[212][from] - characteristic[212][to] |`Number[]` | 194 | |На день рождения **(Аренда посуточно)** |characteristic[1595] | `Number`| 195 | |Цена/сутки **(Аренда посуточно)** |characteristic[237][from] - characteristic[237][to] |`Number[]` | 196 | |Цена/час **(Аренда посуточно)** |characteristic[238][from] - characteristic[238][to] |`Number[]` | 197 | |Цена/неделю |characteristic[279][from] - characteristic[279][to] |`Number[]` | 198 | |Тип валюты |characteristic[246] | `Number`| 199 | |Тип предложения |characteristic[1437] | `Number`| 200 | |Только с картой |with_map |`Number` | 201 | |Только с видео | with_video | `Number`| 202 | |Только с фото |with_photo | `Number`| 203 | |Только с фото (более 3 фото)| photos_count_from|`Number` | 204 | |Только ТОП| urgent_only| `Number`| 205 | |Залоговое имущество | banks_only|`Number` | 206 | |Вторичное жилье |secondary | `Number`| 207 | |Первичное жилье | newbuildings| `Number`| 208 | |Не показывать мои объявления | exclude_my| `Number`| 209 | |Не показывать объявления от агентств|exclude_agencies |`Number` | 210 | |Дата подачи |date_from - date_to |`Number` | 211 | |Страница|page |`Number` | 212 | 213 | 214 | ### Продажа офисов 215 | 216 | | Название | Параметр в строке запроса | Тип данных | 217 | |:--------------------|:--------------------------|:------------:| 218 | |Тип объекта | category| `Number` | 219 | |Тип недвижимости |realty_type | `Number` | 220 | |Тип операции | operation_type| `Number` | 221 | |Область | state_id|`Number` | 222 | |Город | city_id| `Number[]`| 223 | |Район | district_id|`Number[]` | 224 | |Количество помещений |characteristic[210][from] - characteristic[210][to] | `Number[]`| 225 | |Тип объекта для Офисов |characteristic[162] | `Number`| 226 | |Общая |characteristic[214][from] - characteristic[214][to] | `Number[]`| 227 | |Полезная |characteristic[217][from] - characteristic[217][to] | `Number[]`| 228 | |Этаж |characteristic[227][from] - characteristic[227][to] | `Number[]`| 229 | |Этажность |characteristic[228][from] - characteristic[228][to] | `Number[]`| 230 | |Участок |characteristic[219][from] - characteristic[219][to] |`Number[]` | 231 | |Цена за (объект/кв.м.) |characteristic[247] |`Number` | 232 | |Единица измерения площади участка |characteristic[226] |`Number`| 233 | |Мансардный этаж |characteristic[230] | `Number`| 234 | |Подвальный / цокольный этаж |characteristic[231] | `Number`| 235 | |Цена |characteristic[234][from] - characteristic[234][to] | `Number[]`| 236 | |Цена договорная |characteristic[1011] | `Number`| 237 | |Стартовая цена |characteristic[1464] | `Number`| 238 | |Возможен торг |characteristic[273] | `Number`| 239 | |Возможна расстрочка/кредит |characteristic[274] | `Number`| 240 | |Возможен обмен |characteristic[265] |`Number` | 241 | |Тип валюты |characteristic[242] | `Number`| 242 | |Тип предложения |characteristic[1437] | `Number`| 243 | |Возможна расстрочка/кредит |characteristic[274] | `Number`| 244 | |Только с картой |with_map | `Number`| 245 | |Только с видео | with_video | `Number`| 246 | |Только с фото |with_photo |`Number` | 247 | |Только с фото (более 3 фото)| photos_count_from| `Number`| 248 | |Только ТОП| urgent_only| `Number`| 249 | |Залоговое имущество | banks_only| `Number`| 250 | |Вторичное жилье |secondary |`Number` | 251 | |Первичное жилье | newbuildings| `Number`| 252 | |Не показывать мои объявления | exclude_my| `Number`| 253 | |Не показывать объявления от агентств|exclude_agencies | `Number`| 254 | |Дата подачи |date_from - date_to |`Number` | 255 | |Страница|page |`Number` | 256 | 257 | 258 | ### Аренда офисов 259 | 260 | | Название | Параметр в строке запроса | Тип данных | 261 | |:--------------------|:--------------------------|:------------:| 262 | |Тип объекта | category| `Number` | 263 | |Тип недвижимости |realty_type | `Number` | 264 | |Тип операции | operation_type| `Number` | 265 | |Область | state_id|`Number` | 266 | |Город | city_id|`Number[]` | 267 | |Район | district_id| `Number[]`| 268 | |Количество помещений |characteristic[210][from] - characteristic[210][to] | `Number[]`| 269 | |Тип объекта для Офисов |characteristic[155] | `Number`| 270 | |Общая |characteristic[214][from] - characteristic[214][to] | `Number[]`| 271 | |Полезная |characteristic[217][from] - characteristic[217][to] | `Number[]`| 272 | |Этаж |characteristic[227][from] - characteristic[227][to] |`Number[]` | 273 | |Этажность |characteristic[228][from] - characteristic[228][to] | `Number[]`| 274 | |Цена/месяц |characteristic[235][from] - characteristic[235][to] | `Number[]`| 275 | |Цена договорная |characteristic[1011] | `Number`| 276 | |Дополнительные платежи |characteristic[254] |`Number` | 277 | |Возможен торг |characteristic[273] | `Number`| 278 | |Тип валюты |characteristic[242] | `Number`| 279 | |Цена за (объект/кв.м.) |characteristic[247] |`Number` | 280 | |Тип предложения |characteristic[1437] |`Number` | 281 | |Возможна расстрочка/кредит |characteristic[274] |`Number` | 282 | |Только с картой |with_map |`Number` | 283 | |Только с видео | with_video | `Number`| 284 | |Только с фото |with_photo | `Number`| 285 | |Только с фото (более 3 фото)| photos_count_from| `Number`| 286 | |Только ТОП| urgent_only| `Number`| 287 | |Залоговое имущество | banks_only| `Number`| 288 | |Вторичное жилье |secondary |`Number` | 289 | |Первичное жилье | newbuildings| `Number`| 290 | |Не показывать мои объявления | exclude_my| `Number`| 291 | |Не показывать объявления от агентств|exclude_agencies | `Number`| 292 | |Дата подачи |date_from - date_to | `Number`| 293 | |Страница|page | `Number`| 294 | 295 | ### Продажа/аренда коммерческой недвижимости 296 | 297 | | Название | Параметр в строке запроса | Тип данных | 298 | |:--------------------|:--------------------------|:------------:| 299 | |Тип объекта | category| `Number` | 300 | |Тип недвижимости |realty_type | `Number` | 301 | |Тип операции | operation_type| `Number` | 302 | |Область | state_id|`Number` | 303 | |Город | city_id|`Number[]` | 304 | |Район | district_id| `Number[]`| 305 | |Количество помещений |characteristic[210][from] - characteristic[210][to] |`Number[]` | 306 | |Тип объекта-торговые площади |characteristic[169] | `Number`| 307 | |Общая |characteristic[214][from] - characteristic[214][to] | `Number[]`| 308 | |Полезная |characteristic[217][from] - characteristic[217][to] | `Number[]`| 309 | |Этаж |characteristic[227][from] - characteristic[227][to] |`Number[]` | 310 | |Этажность |characteristic[228][from] - characteristic[228][to] | `Number[]`| 311 | |Участок |characteristic[219][from] - characteristic[219][to] |`Number[]` | 312 | |Единица измерения площади участка |characteristic[226] | `Number`| 313 | |Сфера **Готовый бизнес** |characteristic[199] | `Number`| 314 | |Тип объекта-складские помещени |characteristic[159] | `Number`| 315 | |Тип объекта-производственные помещения |characteristic[162] |`Number` | 316 | |Действующий бизнес |characteristic[1438] | `Number`| 317 | |Цена |characteristic[235][from] - characteristic[235][to] |`Number[]` | 318 | |Цена/месяц **Аренда**|characteristic[235][from] - characteristic[235][to] |`Number[]` | 319 | |Дополнительные платежи **Аренда** |characteristic[254] |`Number` | 320 | |Цена договорная |characteristic[1011] |`Number` | 321 | |Стартовая цена |characteristic[1464] |`Number` | 322 | |Тип валюты |characteristic[242] |`Number` | 323 | |Возможен обмен |characteristic[265] | `Number`| 324 | |Возможен торг |characteristic[273] | `Number`| 325 | |Возможна расстрочка/кредит |characteristic[274] | `Number`| 326 | |Цена за (объект / квадратный метр) |characteristic[247] |`Number` | 327 | |Тип предложения |characteristic[1437] |`Number` | 328 | |Только с картой |with_map | `Number`| 329 | |Только с видео | with_video | `Number`| 330 | |Только с фото |with_photo | `Number`| 331 | |Только с фото (более 3 фото)| photos_count_from| `Number`| 332 | |Только ТОП| urgent_only| `Number`| 333 | |Залоговое имущество | banks_only| `Number`| 334 | |Вторичное жилье |secondary | `Number`| 335 | |Первичное жилье | newbuildings| `Number`| 336 | |Не показывать мои объявления | exclude_my| `Number`| 337 | |Не показывать объявления от агентств|exclude_agencies |`Number` | 338 | |Дата подачи |date_from - date_to | `Number`| 339 | |Страница|page |`Number` | 340 | 341 | ### Продажа/аренда земельных участков 342 | 343 | | Название | Параметр в строке запроса | Тип данных | 344 | |:--------------------|:--------------------------|:------------:| 345 | |Тип объекта | category| `Number` | 346 | |Тип недвижимости |realty_type | `Number` | 347 | |Тип операции | operation_type| `Number` | 348 | |Область | state_id| `Number`| 349 | |Город | city_id| `Number[]`| 350 | |Район | district_id|`Number[]` | 351 | |Площадь примерно от |characteristic[1424][from] - characteristic[1424][to] |`Number[]` | 352 | |Площадь примерно до |characteristic[1465][from] - characteristic[1465][to] | `Number[]`| 353 | |Единица измерения площади участка |characteristic[226] | `Number`| 354 | |В коттеджном городке |characteristic[1604] | `Number`| 355 | |Свет |characteristic[1601] |`Number` | 356 | |Вода |characteristic[1602] | `Number`| 357 | |Газ |characteristic[1600] | `Number`| 358 | |Канализация |characteristic[1603] |`Number` | 359 | |Цена |characteristic[234][from] - characteristic[234][to] |`Number[]` | 360 | |Тип цены|characteristic[251] | `Number`| 361 | |Цена договорная |characteristic[1011] |`Number` | 362 | |Стартовая цена |characteristic[1464] | `Number`| 363 | |Тип валюты |characteristic[242] |`Number` | 364 | |Возможен обмен |characteristic[265] | `Number`| 365 | |Возможен торг |characteristic[273] |`Number` | 366 | |Возможна расстрочка/кредит |characteristic[274] |`Number` | 367 | |Цена/год **Аренда** |characteristic[236][from] - characteristic[236][to] |`Number[]` | 368 | |Предоплата **Аренда** |characteristic[1362][from] - characteristic[1362][to] | `Number[]`| 369 | |Тип предложения |characteristic[1437] |`Number` | 370 | |Только с картой |with_map | `Number`| 371 | |Только с видео | with_video | `Number`| 372 | |Только с фото |with_photo |`Number` | 373 | |Только с фото (более 3 фото)| photos_count_from| `Number`| 374 | |Только ТОП| urgent_only| `Number`| 375 | |Залоговое имущество | banks_only| `Number`| 376 | |Вторичное жилье |secondary | `Number`| 377 | |Первичное жилье | newbuildings| `Number`| 378 | |Не показывать мои объявления | exclude_my| `Number`| 379 | |Не показывать объявления от агентств|exclude_agencies |`Number` | 380 | |Дата подачи |date_from - date_to | `Number`| 381 | |Страница|page |`Number` | 382 | 383 | ### Продажа/аренда гаражей 384 | 385 | | Название | Параметр в строке запроса | Тип данных | 386 | |:--------------------|:--------------------------|:------------:| 387 | |Тип объекта | category| `Number` | 388 | |Тип недвижимости |realty_type | `Number` | 389 | |Тип операции | operation_type| `Number` | 390 | |Область | state_id| `Number`| 391 | |Город | city_id| `Number[]`| 392 | |Район | district_id|`Number[]` | 393 | |Машиномест |characteristic[211][from] - characteristic[211][to] | `Number[]`| 394 | |Общая |characteristic[214][from] - characteristic[214][to] | `Number[]`| 395 | |Назначение |characteristic[175] | `Number`| 396 | |Цена |characteristic[234][from] - characteristic[234][to] |`Number[]` | 397 | |Цена |characteristic[235][from] - characteristic[235][to] | `Number[]`| 398 | |Цена договорная |characteristic[1011] | `Number`| 399 | |Стартовая цена |characteristic[1464] | `Number`| 400 | |Тип валюты |characteristic[242] |`Number` | 401 | |Возможен обмен |characteristic[265] | `Number`| 402 | |Возможен торг |characteristic[273] |`Number` | 403 | |Возможна расстрочка/кредит |characteristic[274] | `Number`| 404 | |Тип предложения |characteristic[1437] | `Number`| 405 | |Только с картой |with_map | `Number`| 406 | |Только с видео | with_video | `Number`| 407 | |Только с фото |with_photo |`Number` | 408 | |Только с фото (более 3 фото)| photos_count_from|`Number` | 409 | |Только ТОП| urgent_only| `Number`| 410 | |Залоговое имущество | banks_only|`Number` | 411 | |Вторичное жилье |secondary | `Number`| 412 | |Первичное жилье | newbuildings| `Number`| 413 | |Не показывать мои объявления | exclude_my| `Number`| 414 | |Не показывать объявления от агентств|exclude_agencies |`Number` | 415 | |Дата подачи |date_from - date_to |`Number` | 416 | |Страница|page |`Number` | 417 | 418 | 419 | ## Тип объекта 420 | 421 | Данный параметр может принимать следующие значения: 422 | 423 | `1` Квартиры 424 | 425 | `4` Дома 426 | 427 | `13` Офисы 428 | 429 | `10` Коммерческая 430 | 431 | `24` Участки 432 | 433 | `30` Гаражи 434 | 435 | ## Тип недвижимости 436 | 437 | Тип недвижимости зависит от типа объекта. Следовательно, для **'Квартиры'** тип недвижимости будет следующим: 438 | 439 | `2` Квартира 440 | 441 | `3` Комнаты 442 | 443 | **Для 'Дома':** 444 | 445 | `5` Дом 446 | 447 | `6` Часть 448 | 449 | `7` Дачи 450 | 451 | **Для офисов:** 452 | 453 | `11` Офисные помещения 454 | 455 | `12` Офисные здания 456 | 457 | **Для коммерческой недвижимости:** 458 | 459 | `14` Площади 460 | 461 | `15` Склады 462 | 463 | `16` Производство 464 | 465 | `17` Рестораны 466 | 467 | `18` Объект 468 | 469 | `19` Отель 470 | 471 | `20` Пансионаты 472 | 473 | `21` Помещения свободного назначения 474 | 475 | `22` Бизнес 476 | 477 | **Для участков:** 478 | 479 | `25` Под застройку 480 | 481 | `26` Коммерческие 482 | 483 | `27` Сельскохозяйственные 484 | 485 | `28` Рекреационные 486 | 487 | `29` Природные 488 | 489 | **Для гаражей:** 490 | 491 | `31` Бокс 492 | 493 | `32` Паркинг 494 | 495 | `33` Кооператив 496 | 497 | `34` Гараж 498 | 499 | `35` Стоянка 500 | 501 | 502 | 503 | ## Тип операции 504 | 505 | `0` Любая операция 506 | 507 | `1` Продажа 508 | 509 | `3` Долгострочная аренда 510 | 511 | `4` Посуточная аренда 512 | 513 | 514 | ## Список характеристик недвижимости 515 | 516 | Получить список областей можно отправив GET запрос по адресу [https://developers.ria.com/dom/options?category=id&realty_type=id&operation_type=id&api_key=YOUR_API_KEY](https://developers.ria.com/dom/options?category=id&realty_type=id&operation_type=id&api_key=YOUR_API_KEY). 517 | , где 518 | 519 | - *category* - тип объекта 520 | 521 | - *realty_type* - тип недвижимости 522 | 523 | - *operation_type* - тип операции 524 | 525 | или `curl -X GET "https://developers.ria.com/dom/options?category=id&realty_type=id&operation_type=id&api_key=YOUR_API_KEY" -H "accept: application/json"` 526 | 527 | Для получение информации на украинском языке нужно добавить параметр *lang_id=4* 528 | 529 | Полное описание сервиса "Список характеристик недвижимости" описанный с помощью стандарта DeFacto swagger 2.0 [здесь](http://swagger.ria.com/ui/?api=dom/options) 530 | 531 | **Пример** 532 | 533 | Допусти Вам нужно получить список характеристик объекта 'Дома', а тип недвижимости - 'Дачи', тип операции - 'Продажа' 534 | 535 | Данный запрос будет выглядеть так: 536 | 537 | https://developers.ria.com/dom/options?category=4&realty_type=7&operation_type=1&api_key=YOUR_API_KEY 538 | 539 | или `curl -X GET "https://developers.ria.com/dom/options?category=4&realty_type=7&operation_type=1&api_key=YOUR_API_KEY" -H "accept: application/json"` 540 | 541 | Результат будет следующим: 542 | ```json 543 | [ 544 | { 545 | "group_name": "комнаты", 546 | "group_prio": 150, 547 | "items": [ 548 | { 549 | "characteristic_id": 209, 550 | "label": "комнат", 551 | "label_uk": "кімнат", 552 | "type_on_add": "text", 553 | "type_on_search": "text", 554 | "data_type": "int", 555 | "required": 1, 556 | "characteristic_category": "main", 557 | "prio": 150, 558 | "name": "Комнат", 559 | "group_name": "комнаты", 560 | "group_name_uk": "кімнати", 561 | "field_name": "rooms_count", 562 | "display_label_search": 0, 563 | "display_label_add": 0, 564 | "group_orientation_search": "horisontal", 565 | "group_orientation_add": "horisontal", 566 | "empty_value": 0, 567 | "type": "characteristic", 568 | "group_prio": 0 569 | } 570 | ] 571 | }, 572 | { 573 | "group_name": "Тип стен", 574 | "group_prio": 100, 575 | "items": [ 576 | { 577 | "characteristic_id": 149, 578 | "label": "тип стен", 579 | "label_uk": "тип стін", 580 | "type_on_add": "select", 581 | "type_on_search": "checkbox", 582 | "data_type": "int", 583 | "required": 1, 584 | "characteristic_category": "main", 585 | "prio": 100, 586 | "name": "тип стен для дома", 587 | "group_name": "Тип стен", 588 | "group_name_uk": "Тип стін", 589 | "children": { 590 | "129": { 591 | "characteristic_id": "129", 592 | "name": "кирпич", 593 | "name_uk": "цегла", 594 | "prio": "200" 595 | }, 596 | "130": { 597 | "characteristic_id": "130", 598 | "name": "кирпич силикатный", 599 | "name_uk": "цегла силікатна", 600 | "prio": "190" 601 | }, 602 | "131": { 603 | "characteristic_id": "131", 604 | "name": "кирпич саманный", 605 | "name_uk": "цегла саманна", 606 | "prio": "180" 607 | }, 608 | "132": { 609 | "characteristic_id": "132", 610 | "name": "дерево и кирпич", 611 | "name_uk": "дерево та цегла", 612 | "prio": "170" 613 | }, 614 | "133": { 615 | "characteristic_id": "133", 616 | "name": "панель", 617 | "name_uk": "панель", 618 | "prio": "160" 619 | }, 620 | "134": { 621 | "characteristic_id": "134", 622 | "name": "пеноблок", 623 | "name_uk": "пеноблок", 624 | "prio": "150" 625 | }, 626 | "135": { 627 | "characteristic_id": "135", 628 | "name": "керамзитобетон", 629 | "name_uk": "керамзітобетон", 630 | "prio": "140" 631 | }, 632 | "136": { 633 | "characteristic_id": "136", 634 | "name": "монолит", 635 | "name_uk": "моноліт", 636 | "prio": "130" 637 | }, 638 | "138": { 639 | "characteristic_id": "138", 640 | "name": "сруб", 641 | "name_uk": "зруб", 642 | "prio": "110" 643 | }, 644 | "139": { 645 | "characteristic_id": "139", 646 | "name": "брус", 647 | "name_uk": "брус", 648 | "prio": "100" 649 | }, 650 | "140": { 651 | "characteristic_id": "140", 652 | "name": "каркасно-щитовой", 653 | "name_uk": "каркасно-щитовий", 654 | "prio": "90" 655 | }, 656 | "141": { 657 | "characteristic_id": "141", 658 | "name": "глинобитный", 659 | "name_uk": "глинобитний", 660 | "prio": "80" 661 | }, 662 | "142": { 663 | "characteristic_id": "142", 664 | "name": "пенобетон", 665 | "name_uk": "пінобетон", 666 | "prio": "70" 667 | }, 668 | "143": { 669 | "characteristic_id": "143", 670 | "name": "газобетон", 671 | "name_uk": "газобетон", 672 | "prio": "60" 673 | }, 674 | "144": { 675 | "characteristic_id": "144", 676 | "name": "сендвич-панели", 677 | "name_uk": "сендвіч-панелі", 678 | "prio": "50" 679 | }, 680 | "145": { 681 | "characteristic_id": "145", 682 | "name": "метал", 683 | "name_uk": "метал", 684 | "prio": "40" 685 | }, 686 | "146": { 687 | "characteristic_id": "146", 688 | "name": "поротерм", 689 | "name_uk": "поротерм", 690 | "prio": "30" 691 | }, 692 | "147": { 693 | "characteristic_id": "147", 694 | "name": "ракушечник (ракушняк)", 695 | "name_uk": "ракушняк", 696 | "prio": "20" 697 | }, 698 | "148": { 699 | "characteristic_id": "148", 700 | "name": "инкерманский камень", 701 | "name_uk": "інкерманський камінь", 702 | "prio": "10" 703 | }, 704 | "1433": { 705 | "characteristic_id": "1433", 706 | "name": "шлакобетон", 707 | "name_uk": "шлакобетон", 708 | "prio": "65" 709 | }, 710 | "1441": { 711 | "characteristic_id": "1441", 712 | "name": "шлакоблок", 713 | "name_uk": "шлакоблок", 714 | "prio": "55" 715 | }, 716 | "1442": { 717 | "characteristic_id": "1442", 718 | "name": "наливной", 719 | "name_uk": "наливний", 720 | "prio": "5" 721 | }, 722 | "1444": { 723 | "characteristic_id": "1444", 724 | "name": "бутовый камень", 725 | "name_uk": "бутовий камінь", 726 | "prio": "4" 727 | }, 728 | "1445": { 729 | "characteristic_id": "1445", 730 | "name": "мергель", 731 | "name_uk": "мергель", 732 | "prio": "3" 733 | }, 734 | "1447": { 735 | "characteristic_id": "1447", 736 | "name": "крупноблочный известняк", 737 | "name_uk": "великоблочний вапняк", 738 | "prio": "2" 739 | }, 740 | "1463": { 741 | "characteristic_id": "1463", 742 | "name": "термоблок", 743 | "name_uk": "термоблок", 744 | "prio": "1" 745 | }, 746 | "1597": { 747 | "characteristic_id": "1597", 748 | "name": "сип панель ", 749 | "name_uk": "сіп панель", 750 | "prio": "56" 751 | }, 752 | "1598": { 753 | "characteristic_id": "1598", 754 | "name": "контейнер ", 755 | "name_uk": "контейнер", 756 | "prio": "7" 757 | } 758 | }, 759 | "field_name": "wall_type", 760 | "display_label_search": 0, 761 | "display_label_add": 0, 762 | "group_orientation_search": "horisontal", 763 | "group_orientation_add": "horisontal", 764 | "empty_value": 0, 765 | "type": "characteristic", 766 | "group_prio": 0 767 | } 768 | ] 769 | }, 770 | { 771 | "group_name": "площадь помещений", 772 | "group_prio": 90, 773 | "items": [ 774 | { 775 | "characteristic_id": 215, 776 | "label": "общая пл.", 777 | "label_uk": "загальна пл.", 778 | "type_on_add": "text", 779 | "type_on_search": "text", 780 | "data_type": "float", 781 | "required": 1, 782 | "sufix": "м.кв.", 783 | "characteristic_category": "main", 784 | "prio": 4, 785 | "name": "площадь дома", 786 | "group_name": "площадь помещений", 787 | "group_name_uk": "площа приміщень", 788 | "group_prio": 90, 789 | "field_name": "total_square_meters", 790 | "display_label_search": 0, 791 | "display_label_add": 0, 792 | "group_orientation_search": "horisontal", 793 | "group_orientation_add": "horisontal", 794 | "empty_value": 0, 795 | "type": "characteristic" 796 | }, 797 | { 798 | "characteristic_id": 216, 799 | "label": "жилая", 800 | "label_uk": "житлова", 801 | "type_on_add": "text", 802 | "type_on_search": "text", 803 | "data_type": "float", 804 | "required": 0, 805 | "sufix": "кв. м", 806 | "characteristic_category": "main", 807 | "prio": 3, 808 | "name": "жилая площадь", 809 | "group_name": "площадь помещений", 810 | "group_name_uk": "площа приміщень", 811 | "group_prio": 90, 812 | "field_name": "living_square_meters", 813 | "display_label_search": 0, 814 | "display_label_add": 0, 815 | "group_orientation_search": "horisontal", 816 | "group_orientation_add": "horisontal", 817 | "empty_value": 0, 818 | "type": "characteristic" 819 | }, 820 | { 821 | "characteristic_id": 218, 822 | "label": "кухня", 823 | "label_uk": "кухня", 824 | "type_on_add": "text", 825 | "type_on_search": "text", 826 | "data_type": "float", 827 | "required": 0, 828 | "sufix": "кв. м", 829 | "characteristic_category": "main", 830 | "prio": 2, 831 | "name": "кухня", 832 | "group_name": "площадь помещений", 833 | "group_name_uk": "площа приміщень", 834 | "group_prio": 90, 835 | "field_name": "kitchen_square_meters", 836 | "display_label_search": 0, 837 | "display_label_add": 0, 838 | "group_orientation_search": "horisontal", 839 | "group_orientation_add": "horisontal", 840 | "empty_value": 0, 841 | "type": "characteristic" 842 | } 843 | ] 844 | }, 845 | { 846 | "group_name": "площадь участка", 847 | "group_prio": 83, 848 | "items": [ 849 | { 850 | "characteristic_id": 219, 851 | "label": "участок", 852 | "label_uk": "ділянка", 853 | "type_on_add": "text", 854 | "type_on_search": "text", 855 | "data_type": "float", 856 | "required": 0, 857 | "characteristic_category": "main", 858 | "prio": 10, 859 | "name": "площадь участка", 860 | "group_name": "площадь участка", 861 | "group_name_uk": "площа ділянки", 862 | "group_prio": 85, 863 | "field_name": "ares_count", 864 | "display_label_search": 0, 865 | "display_label_add": 0, 866 | "group_orientation_search": "horisontal", 867 | "group_orientation_add": "horisontal", 868 | "empty_value": 0, 869 | "type": "characteristic" 870 | }, 871 | { 872 | "characteristic_id": 226, 873 | "label": "единица измерения", 874 | "label_uk": "одиниця виміру", 875 | "type_on_add": "select", 876 | "type_on_search": "select", 877 | "data_type": "int", 878 | "required": 0, 879 | "characteristic_category": "main", 880 | "prio": 2, 881 | "name": "единица измерения площади участка", 882 | "group_name": "площадь участка", 883 | "group_name_uk": "площа ділянки", 884 | "group_prio": 83, 885 | "children": { 886 | "223": { 887 | "characteristic_id": "223", 888 | "name": "сотка", 889 | "name_uk": "сотка", 890 | "prio": "3" 891 | }, 892 | "224": { 893 | "characteristic_id": "224", 894 | "name": "Га (гектар)", 895 | "name_uk": "Га (гектар)", 896 | "prio": "2" 897 | }, 898 | "225": { 899 | "characteristic_id": "225", 900 | "name": "кв. м", 901 | "name_uk": "кв. м", 902 | "prio": "1" 903 | } 904 | }, 905 | "field_name": "lot_unit", 906 | "display_label_search": 0, 907 | "display_label_add": 0, 908 | "group_orientation_search": "horisontal", 909 | "group_orientation_add": "horisontal", 910 | "empty_value": 0, 911 | "type": "characteristic" 912 | } 913 | ] 914 | }, 915 | { 916 | "group_name": "этаж", 917 | "group_prio": 75, 918 | "items": [ 919 | { 920 | "characteristic_id": 1494, 921 | "label": "у озера", 922 | "label_uk": "біля озера", 923 | "type_on_add": "checkbox", 924 | "type_on_search": "checkbox", 925 | "data_type": "int", 926 | "required": 0, 927 | "characteristic_category": "main", 928 | "prio": 4, 929 | "name": "у озера", 930 | "group_name": "этаж", 931 | "group_name_uk": "поверх", 932 | "group_prio": 75, 933 | "display_label_search": 1, 934 | "display_label_add": 1, 935 | "group_orientation_search": "horisontal", 936 | "group_orientation_add": "horisontal", 937 | "empty_value": 0, 938 | "type": "characteristic" 939 | }, 940 | { 941 | "characteristic_id": 1493, 942 | "label": "у реки", 943 | "label_uk": "біля річки", 944 | "type_on_add": "checkbox", 945 | "type_on_search": "checkbox", 946 | "data_type": "int", 947 | "required": 0, 948 | "characteristic_category": "main", 949 | "prio": 3, 950 | "name": "у реки", 951 | "group_name": "этаж", 952 | "group_name_uk": "поверх", 953 | "group_prio": 75, 954 | "display_label_search": 1, 955 | "display_label_add": 1, 956 | "group_orientation_search": "horisontal", 957 | "group_orientation_add": "horisontal", 958 | "empty_value": 0, 959 | "type": "characteristic" 960 | }, 961 | { 962 | "characteristic_id": 230, 963 | "label": "мансардный этаж", 964 | "label_uk": "мансардний поверх", 965 | "type_on_add": "checkbox", 966 | "type_on_search": "checkbox", 967 | "data_type": "int", 968 | "required": 0, 969 | "characteristic_category": "main", 970 | "prio": 2, 971 | "name": "мансардный этаж", 972 | "group_name": "этаж", 973 | "group_name_uk": "поверх", 974 | "group_prio": 75, 975 | "display_label_search": 0, 976 | "display_label_add": 0, 977 | "group_orientation_search": "horisontal", 978 | "group_orientation_add": "horisontal", 979 | "empty_value": 0, 980 | "type": "characteristic" 981 | }, 982 | { 983 | "characteristic_id": 231, 984 | "label": "подвальный / цокольный этаж", 985 | "label_uk": "підвальний / цокольний поверх", 986 | "type_on_add": "checkbox", 987 | "type_on_search": "checkbox", 988 | "data_type": "int", 989 | "required": 0, 990 | "characteristic_category": "main", 991 | "prio": 1, 992 | "name": "подвальный / цокольный этаж", 993 | "group_name": "этаж", 994 | "group_name_uk": "поверх", 995 | "group_prio": 75, 996 | "display_label_search": 0, 997 | "display_label_add": 0, 998 | "group_orientation_search": "horisontal", 999 | "group_orientation_add": "horisontal", 1000 | "empty_value": 0, 1001 | "type": "characteristic" 1002 | } 1003 | ] 1004 | }, 1005 | { 1006 | "group_name": "характеристика здания", 1007 | "group_prio": 70, 1008 | "items": [ 1009 | { 1010 | "characteristic_id": 443, 1011 | "label": "год постройки", 1012 | "label_uk": "рік побудови", 1013 | "type_on_add": "select", 1014 | "type_on_search": "checkbox", 1015 | "data_type": "int", 1016 | "required": 0, 1017 | "default_value": "не указано", 1018 | "characteristic_category": "main", 1019 | "prio": 160, 1020 | "name": "год постройки", 1021 | "group_name": "характеристика здания", 1022 | "group_name_uk": "характеристика будівлі", 1023 | "group_prio": 70, 1024 | "children": { 1025 | "421": { 1026 | "characteristic_id": "421", 1027 | "name": "2015, IV кв.", 1028 | "name_uk": "2015, IV кв.", 1029 | "prio": "25" 1030 | }, 1031 | "422": { 1032 | "characteristic_id": "422", 1033 | "name": "2013", 1034 | "name_uk": "2013", 1035 | "prio": "20" 1036 | }, 1037 | "423": { 1038 | "characteristic_id": "423", 1039 | "name": "2012", 1040 | "name_uk": "2012", 1041 | "prio": "19" 1042 | }, 1043 | "424": { 1044 | "characteristic_id": "424", 1045 | "name": "2011 ", 1046 | "name_uk": "2011", 1047 | "prio": "18" 1048 | }, 1049 | "425": { 1050 | "characteristic_id": "425", 1051 | "name": "2010", 1052 | "name_uk": "2010", 1053 | "prio": "17" 1054 | }, 1055 | "426": { 1056 | "characteristic_id": "426", 1057 | "name": "2009", 1058 | "name_uk": "2009", 1059 | "prio": "16" 1060 | }, 1061 | "427": { 1062 | "characteristic_id": "427", 1063 | "name": "2008", 1064 | "name_uk": "2008", 1065 | "prio": "15" 1066 | }, 1067 | "428": { 1068 | "characteristic_id": "428", 1069 | "name": "2007", 1070 | "name_uk": "2007", 1071 | "prio": "14" 1072 | }, 1073 | "429": { 1074 | "characteristic_id": "429", 1075 | "name": "2006", 1076 | "name_uk": "2006", 1077 | "prio": "13" 1078 | }, 1079 | "434": { 1080 | "characteristic_id": "434", 1081 | "name": "2001-2005", 1082 | "name_uk": "2001-2005", 1083 | "prio": "8" 1084 | }, 1085 | "435": { 1086 | "characteristic_id": "435", 1087 | "name": "1990-2000", 1088 | "name_uk": "1990-2000", 1089 | "prio": "7" 1090 | }, 1091 | "436": { 1092 | "characteristic_id": "436", 1093 | "name": "1980-1989", 1094 | "name_uk": "1980-1989", 1095 | "prio": "6" 1096 | }, 1097 | "437": { 1098 | "characteristic_id": "437", 1099 | "name": "1970-1979", 1100 | "name_uk": "1970-1979", 1101 | "prio": "5" 1102 | }, 1103 | "438": { 1104 | "characteristic_id": "438", 1105 | "name": "1960-1969", 1106 | "name_uk": "1960-1969", 1107 | "prio": "4" 1108 | }, 1109 | "439": { 1110 | "characteristic_id": "439", 1111 | "name": "1944-1959", 1112 | "name_uk": "1944-1959", 1113 | "prio": "3" 1114 | }, 1115 | "440": { 1116 | "characteristic_id": "440", 1117 | "name": "1917-1942", 1118 | "name_uk": "1917-1942", 1119 | "prio": "2" 1120 | }, 1121 | "441": { 1122 | "characteristic_id": "441", 1123 | "name": "раньше 1917", 1124 | "name_uk": "до 1917", 1125 | "prio": "1" 1126 | }, 1127 | "442": { 1128 | "characteristic_id": "442", 1129 | "name": "не указано", 1130 | "name_uk": "не вказано", 1131 | "prio": "36" 1132 | }, 1133 | "1448": { 1134 | "characteristic_id": "1448", 1135 | "name": "2014", 1136 | "name_uk": "2014", 1137 | "prio": "21" 1138 | }, 1139 | "1449": { 1140 | "characteristic_id": "1449", 1141 | "name": "Сдача в 2015", 1142 | "name_uk": "Здача в 2015", 1143 | "prio": "30" 1144 | }, 1145 | "1450": { 1146 | "characteristic_id": "1450", 1147 | "name": "Сдача в 2016", 1148 | "name_uk": "Здача в 2016", 1149 | "prio": "31" 1150 | }, 1151 | "1454": { 1152 | "characteristic_id": "1454", 1153 | "name": "2015, III кв.", 1154 | "name_uk": "2015, III кв.", 1155 | "prio": "24" 1156 | }, 1157 | "1455": { 1158 | "characteristic_id": "1455", 1159 | "name": "2015, II кв.", 1160 | "name_uk": "2015, II кв.", 1161 | "prio": "23" 1162 | }, 1163 | "1456": { 1164 | "characteristic_id": "1456", 1165 | "name": "2015, I кв.", 1166 | "name_uk": "2015, I кв.", 1167 | "prio": "22" 1168 | }, 1169 | "1457": { 1170 | "characteristic_id": "1457", 1171 | "name": "2016, I кв.", 1172 | "name_uk": "2016, I кв.", 1173 | "prio": "26" 1174 | }, 1175 | "1458": { 1176 | "characteristic_id": "1458", 1177 | "name": "2016, II кв.", 1178 | "name_uk": "2016, II кв.", 1179 | "prio": "27" 1180 | }, 1181 | "1459": { 1182 | "characteristic_id": "1459", 1183 | "name": "2016, III кв.", 1184 | "name_uk": "2016, III кв.", 1185 | "prio": "28" 1186 | }, 1187 | "1460": { 1188 | "characteristic_id": "1460", 1189 | "name": "2016, IV кв.", 1190 | "name_uk": "2016, IV кв.", 1191 | "prio": "29" 1192 | }, 1193 | "1468": { 1194 | "characteristic_id": "1468", 1195 | "name": "Сдача в 2017", 1196 | "name_uk": "Здача в 2017", 1197 | "prio": "32" 1198 | }, 1199 | "1469": { 1200 | "characteristic_id": "1469", 1201 | "name": "Сдача в 2018", 1202 | "name_uk": "Здача в 2018", 1203 | "prio": "33" 1204 | }, 1205 | "1470": { 1206 | "characteristic_id": "1470", 1207 | "name": "Сдача в 2019", 1208 | "name_uk": "Здача в 2019", 1209 | "prio": "34" 1210 | }, 1211 | "1471": { 1212 | "characteristic_id": "1471", 1213 | "name": "Сдача в 2020", 1214 | "name_uk": "Здача в 2020", 1215 | "prio": "35" 1216 | } 1217 | }, 1218 | "display_label_search": 0, 1219 | "display_label_add": 0, 1220 | "group_orientation_search": "horisontal", 1221 | "group_orientation_add": "horisontal", 1222 | "empty_value": 0, 1223 | "type": "characteristic" 1224 | } 1225 | ] 1226 | }, 1227 | { 1228 | "group_name": "цена", 1229 | "group_prio": 45, 1230 | "items": [ 1231 | { 1232 | "characteristic_id": 234, 1233 | "label": "цена", 1234 | "label_uk": "ціна", 1235 | "type_on_add": "text", 1236 | "type_on_search": "text", 1237 | "data_type": "int", 1238 | "required": 1, 1239 | "characteristic_category": "main", 1240 | "prio": 96, 1241 | "name": "цена", 1242 | "group_name": "цена", 1243 | "group_name_uk": "ціна", 1244 | "group_prio": 64, 1245 | "field_name": "price", 1246 | "display_label_search": 0, 1247 | "display_label_add": 0, 1248 | "group_orientation_search": "horisontal", 1249 | "group_orientation_add": "horisontal", 1250 | "empty_value": 0, 1251 | "type": "characteristic" 1252 | }, 1253 | { 1254 | "characteristic_id": 1011, 1255 | "label": "цена договорная", 1256 | "label_uk": "ціна договірна", 1257 | "type_on_add": "checkbox", 1258 | "type_on_search": "checkbox", 1259 | "data_type": "int", 1260 | "required": 0, 1261 | "characteristic_category": "main", 1262 | "prio": 95, 1263 | "name": "цена договорная", 1264 | "group_name": "цена", 1265 | "group_name_uk": "ціна", 1266 | "group_prio": 64, 1267 | "field_name": "is_negotiable", 1268 | "display_label_search": 0, 1269 | "display_label_add": 0, 1270 | "group_orientation_search": "horisontal", 1271 | "group_orientation_add": "horisontal", 1272 | "empty_value": 0, 1273 | "type": "characteristic" 1274 | }, 1275 | { 1276 | "characteristic_id": 242, 1277 | "label": "тип валюты", 1278 | "label_uk": "тип валюти", 1279 | "type_on_add": "select", 1280 | "type_on_search": "select", 1281 | "data_type": "int", 1282 | "required": 1, 1283 | "default_value": "$", 1284 | "characteristic_category": "main", 1285 | "prio": 85, 1286 | "name": "тип валюты (USD)", 1287 | "group_name": "цена", 1288 | "group_name_uk": "ціна", 1289 | "group_prio": 64, 1290 | "children": { 1291 | "239": { 1292 | "characteristic_id": "239", 1293 | "name": "$", 1294 | "name_uk": "$", 1295 | "prio": "3" 1296 | }, 1297 | "240": { 1298 | "characteristic_id": "240", 1299 | "name": "грн", 1300 | "name_uk": "грн", 1301 | "prio": "2" 1302 | }, 1303 | "241": { 1304 | "characteristic_id": "241", 1305 | "name": "€", 1306 | "name_uk": "€", 1307 | "prio": "1" 1308 | } 1309 | }, 1310 | "field_name": "currency_type", 1311 | "display_label_search": 0, 1312 | "display_label_add": 0, 1313 | "group_orientation_search": "horisontal", 1314 | "group_orientation_add": "horisontal", 1315 | "empty_value": 0, 1316 | "type": "characteristic" 1317 | }, 1318 | { 1319 | "characteristic_id": 1464, 1320 | "label": "стартовая цена", 1321 | "label_uk": "стартова ціна", 1322 | "type_on_add": "checkbox", 1323 | "type_on_search": "checkbox", 1324 | "data_type": "int", 1325 | "required": 0, 1326 | "characteristic_category": "main", 1327 | "prio": 45, 1328 | "name": "стартовая цена", 1329 | "group_name": "цена", 1330 | "group_name_uk": "ціна", 1331 | "field_name": "start_price", 1332 | "display_label_search": 0, 1333 | "display_label_add": 0, 1334 | "group_orientation_search": "horisontal", 1335 | "group_orientation_add": "horisontal", 1336 | "empty_value": 0, 1337 | "type": "characteristic", 1338 | "group_prio": 0 1339 | }, 1340 | { 1341 | "characteristic_id": 273, 1342 | "label": "возможен торг", 1343 | "label_uk": "можливий торг", 1344 | "type_on_add": "checkbox", 1345 | "type_on_search": "checkbox", 1346 | "data_type": "int", 1347 | "required": 0, 1348 | "characteristic_category": "main", 1349 | "prio": 42, 1350 | "name": "возможен торг", 1351 | "group_name": "цена", 1352 | "group_name_uk": "ціна", 1353 | "field_name": "is_bargain", 1354 | "display_label_search": 0, 1355 | "display_label_add": 0, 1356 | "group_orientation_search": "horisontal", 1357 | "group_orientation_add": "horisontal", 1358 | "empty_value": 0, 1359 | "type": "characteristic", 1360 | "group_prio": 0 1361 | }, 1362 | { 1363 | "characteristic_id": 274, 1364 | "label": "возможна рассрочка / кредит", 1365 | "label_uk": "можлива розстрочка / кредит", 1366 | "type_on_add": "checkbox", 1367 | "type_on_search": "checkbox", 1368 | "data_type": "int", 1369 | "required": 0, 1370 | "characteristic_category": "main", 1371 | "prio": 40, 1372 | "name": "возможна рассрочка / кредит", 1373 | "group_name": "цена", 1374 | "group_name_uk": "ціна", 1375 | "display_label_search": 0, 1376 | "display_label_add": 0, 1377 | "group_orientation_search": "horisontal", 1378 | "group_orientation_add": "horisontal", 1379 | "empty_value": 0, 1380 | "type": "characteristic", 1381 | "group_prio": 0 1382 | }, 1383 | { 1384 | "characteristic_id": 265, 1385 | "label": "возможен обмен", 1386 | "label_uk": "можливий обмін", 1387 | "type_on_add": "select", 1388 | "type_on_search": "select", 1389 | "data_type": "int", 1390 | "required": 0, 1391 | "default_value": "нет", 1392 | "characteristic_category": "main", 1393 | "prio": 35, 1394 | "name": "возможен обмен", 1395 | "group_name": "цена", 1396 | "group_name_uk": "ціна", 1397 | "children": { 1398 | "257": { 1399 | "characteristic_id": "257", 1400 | "name": "нет", 1401 | "name_uk": "ні", 1402 | "prio": "8" 1403 | }, 1404 | "258": { 1405 | "characteristic_id": "258", 1406 | "name": "на авто + моя доплата", 1407 | "name_uk": "на авто + моя доплата", 1408 | "prio": "7" 1409 | }, 1410 | "259": { 1411 | "characteristic_id": "259", 1412 | "name": "на авто без доплаты", 1413 | "name_uk": "на авто без доплати", 1414 | "prio": "6" 1415 | }, 1416 | "260": { 1417 | "characteristic_id": "260", 1418 | "name": "на авто + ваша доплата", 1419 | "name_uk": "на авто + ваша доплата", 1420 | "prio": "5" 1421 | }, 1422 | "261": { 1423 | "characteristic_id": "261", 1424 | "name": "на недвижимость + моя доплата", 1425 | "name_uk": "на нерухомість + моя доплата", 1426 | "prio": "4" 1427 | }, 1428 | "262": { 1429 | "characteristic_id": "262", 1430 | "name": "на недвижимость без доплаты", 1431 | "name_uk": "на нерухомість без доплати", 1432 | "prio": "3" 1433 | }, 1434 | "263": { 1435 | "characteristic_id": "263", 1436 | "name": "на недвижимость + ваша доплата", 1437 | "name_uk": "на нерухомість + ваша доплата", 1438 | "prio": "2" 1439 | }, 1440 | "264": { 1441 | "characteristic_id": "264", 1442 | "name": "рассмотрю любой вариант", 1443 | "name_uk": "розгляну будь-який варіант", 1444 | "prio": "1" 1445 | } 1446 | }, 1447 | "field_name": "is_exchange", 1448 | "display_label_search": 0, 1449 | "display_label_add": 0, 1450 | "group_orientation_search": "horisontal", 1451 | "group_orientation_add": "horisontal", 1452 | "empty_value": 0, 1453 | "type": "characteristic", 1454 | "group_prio": 0 1455 | }, 1456 | { 1457 | "characteristic_id": 1437, 1458 | "label": "тип предложения", 1459 | "label_uk": "тип пропозиції", 1460 | "type_on_add": "select", 1461 | "type_on_search": "checkbox", 1462 | "data_type": "int", 1463 | "required": 0, 1464 | "default_value": "от посредника", 1465 | "characteristic_category": "main", 1466 | "prio": 30, 1467 | "name": "тип предложения", 1468 | "group_name": "цена", 1469 | "group_name_uk": "ціна", 1470 | "group_prio": 64, 1471 | "children": { 1472 | "1434": { 1473 | "characteristic_id": "1434", 1474 | "name": "от посредника", 1475 | "name_uk": "від посередника", 1476 | "prio": "5" 1477 | }, 1478 | "1435": { 1479 | "characteristic_id": "1435", 1480 | "name": "от представителя хозяина (без комиссионных)", 1481 | "name_uk": "від представника власника (без комісійних)", 1482 | "prio": "4" 1483 | }, 1484 | "1436": { 1485 | "characteristic_id": "1436", 1486 | "name": "от собственника", 1487 | "name_uk": "від власника", 1488 | "prio": "2" 1489 | }, 1490 | "1473": { 1491 | "characteristic_id": "1473", 1492 | "name": "от представителя застройщика", 1493 | "name_uk": "від представника забудовника", 1494 | "prio": "3" 1495 | }, 1496 | "1506": { 1497 | "characteristic_id": "1506", 1498 | "name": "от застройщика", 1499 | "name_uk": "від забудовника", 1500 | "prio": "1" 1501 | } 1502 | }, 1503 | "display_label_search": 1, 1504 | "display_label_add": 1, 1505 | "group_orientation_search": "horisontal", 1506 | "group_orientation_add": "horisontal", 1507 | "empty_value": 0, 1508 | "type": "characteristic" 1509 | } 1510 | ] 1511 | } 1512 | ] 1513 | ``` 1514 | 1515 | 1516 | ## Информация по id объявления 1517 | 1518 | Чтобы обратиться к RIA API info, Вам необходимо выполнить GET запрос такого вида: 1519 | 1520 | https://developers.ria.com/dom/info/**id_объявления**?api_key=YOUR_API_KEY 1521 | 1522 | или `curl -i -X GET "https://developers.ria.com/dom/info/id_объявления?api_key=YOUR_API_KEY"` 1523 | 1524 | Полное описание сервиса "Информация по id объявления" описанный с помощью стандарта DeFacto swagger 2.0 [здесь](http://swagger.ria.com/ui/?api=dom/options) 1525 | 1526 | Допусти Вам нужна информация по _13825265_ id. 1527 | 1528 | Данный запрос будет выглядеть так: 1529 | 1530 | https://developers.ria.com/dom/info/13825265?api_key=YOUR_API_KEY 1531 | 1532 | или `curl -i -X GET "https://developers.ria.com/dom/info/13825265?api_key=YOUR_API_KEY` 1533 | 1534 | В случае успешного выполнения запроса результат будет со статусом **200 OK**. 1535 | 1536 | Пример успешного ответа: 1537 | 1538 | ```json 1539 | { 1540 | "street_name": "Онуфрия Трутенко улица", 1541 | "metro_station_id": "15", 1542 | "rooms_count": 2, 1543 | "advert_title": 1, 1544 | "type": "realty", 1545 | "is_commercial": 0, 1546 | "state_name": "Киевская", 1547 | "street_id": 5581, 1548 | "state_id": 10, 1549 | "beautiful_url": "realty-perevireno-prodaja-kvartira-kiev-goloseevskiy-onufriya-trutenko-ulitsa-13825265.html", 1550 | "levels": 64, 1551 | "exchange_required_type": 13, 1552 | "district_type_name": "Район", 1553 | "description": "Светлая квартира, расположена на 23 этаже / 23 эт. дома в ЖК " 4 Сезона", потолок Н-3,5 м., панорамные окна с видом на город. Состояние от застройщика, у Вас есть возможность воплотить дизайнерские фантазии в доме. Дом имеет внешнее утепление, парковку, подземный паркинг, во дворе оборудованная детская площадка. Шикарный район, в шаговой дистанции м. " Васильковская" ( 5 мин.пешком), м. "Ипподром" (10 мин.пешком), м. "Выстовочный Центр"(18 мин. пешком) Голосеевский парк,озёра и пруды, детский сад, школа, магазины, салоны, кафе и рестораны, фитнес центр. ", 1554 | "advert_publish_type": 1, 1555 | "currency_type": "$", 1556 | "district_type_id": 1, 1557 | "longitude": "30.480281005166944", 1558 | "inspected_at": "2017-10-02 14:51:02", 1559 | "levels_expired": "2018-01-01 12:16:32", 1560 | "is_exchange": "рассмотрю любой вариант", 1561 | "district_id": "15184", 1562 | "metro_station_name": "Васильковская", 1563 | "wall_type": "кирпич", 1564 | "publishing_date": "2017-10-02 14:51:07", 1565 | "description_uk": "Світла квартира, розташована на 23 поверсі / 23 пов. будинки в ЖК "4 Сезони", стеля Н-3,5 м., панорамні вікна з видом на місто. Стан від забудовника, у Вас є можливість втілити дизайнерські фантазії в будинку. Будинок має зовнішнє утеплення, місце для паркування, підземний паркінг, у дворі обладнаний дитячий майданчик. Шикарний район, в крокової дистанції м. "Васильківська" ( 5 хв. пішки), м. "Іподром" (10 хв. пішки), м. "Вистовковий Центр"(18 хв. пішки), Голосіївський парк, озера і ставки, дитячий садок, школа, магазини, салони, кафе і ресторани, фітнес-центр. ", 1566 | "youtube_link": "", 1567 | "price_type": "за объект", 1568 | "inspected": 1, 1569 | "is_bargain": 273, 1570 | "price": 60000, 1571 | "floor": 23, 1572 | "latitude": "50.39161687881484", 1573 | "price_total": 60000, 1574 | "main_photo": "dom/photo/8070/807045/80704539/80704539.jpg", 1575 | "price_item": 645, 1576 | "realty_type_name": "Квартира", 1577 | "building_number_str": "3 Г", 1578 | "city_name": "Киев", 1579 | "metro_station_brunch": 2, 1580 | "realty_type_parent_id": 1, 1581 | "living_square_meters": 50, 1582 | "realty_type_id": 2, 1583 | "user_ip": 0, 1584 | "city_id": 10, 1585 | "characteristics_values": { 1586 | "118": 108, 1587 | "209": 2, 1588 | "214": 93, 1589 | "216": 50, 1590 | "218": 20, 1591 | "227": 23, 1592 | "228": 23, 1593 | "234": 60000, 1594 | "242": 239, 1595 | "247": 252, 1596 | "265": 264, 1597 | "273": 273, 1598 | "443": 1449, 1599 | "475": 473, 1600 | "480": 476, 1601 | "516": 512, 1602 | "791": 791, 1603 | "806": 802, 1604 | "808": 808, 1605 | "892": 890, 1606 | "1016": 1016, 1607 | "1020": 1023, 1608 | "1032": 1028, 1609 | "1157": 1149, 1610 | "1403": 1400, 1611 | "1437": 1436, 1612 | "1504": 1504, 1613 | "1571": 1571, 1614 | "1575": 1575, 1615 | "1581": 1581 1616 | }, 1617 | "_id": "realty-13825265", 1618 | "floors_count": 23, 1619 | "created_at": "2017-09-20 21:12:42", 1620 | "user_id": 7160632, 1621 | "kitchen_square_meters": 20, 1622 | "user_package_id": 0, 1623 | "total_square_meters": 93, 1624 | "realty_id": 13825265, 1625 | "realty_sale_type": 2, 1626 | "photos": { 1627 | "80704539": { 1628 | "id": 80704539, 1629 | "file": "dom/photo/8070/807045/80704539/80704539.jpg", 1630 | "o": "h" 1631 | }, 1632 | "80704540": { 1633 | "id": 80704540, 1634 | "file": "dom/photo/8070/807045/80704540/80704540.jpg", 1635 | "o": "h" 1636 | }, 1637 | "80704541": { 1638 | "id": 80704541, 1639 | "file": "dom/photo/8070/807045/80704541/80704541.jpg", 1640 | "o": "h" 1641 | }, 1642 | "80704542": { 1643 | "id": 80704542, 1644 | "file": "dom/photo/8070/807045/80704542/80704542.jpg", 1645 | "o": "h" 1646 | }, 1647 | "80704543": { 1648 | "id": 80704543, 1649 | "file": "dom/photo/8070/807045/80704543/80704543.jpg", 1650 | "o": "v" 1651 | }, 1652 | "80704545": { 1653 | "id": 80704545, 1654 | "file": "dom/photo/8070/807045/80704545/80704545.jpg", 1655 | "o": "v" 1656 | }, 1657 | "80704546": { 1658 | "id": 80704546, 1659 | "file": "dom/photo/8070/807045/80704546/80704546.jpg", 1660 | "o": "v" 1661 | }, 1662 | "80704547": { 1663 | "id": 80704547, 1664 | "file": "dom/photo/8070/807045/80704547/80704547.jpg", 1665 | "o": "v" 1666 | }, 1667 | "80704548": { 1668 | "id": 80704548, 1669 | "file": "dom/photo/8070/807045/80704548/80704548.jpg", 1670 | "o": "v" 1671 | }, 1672 | "80704550": { 1673 | "id": 80704550, 1674 | "file": "dom/photo/8070/807045/80704550/80704550.jpg", 1675 | "o": "h" 1676 | }, 1677 | "80704552": { 1678 | "id": 80704552, 1679 | "file": "dom/photo/8070/807045/80704552/80704552.jpg", 1680 | "o": "h" 1681 | } 1682 | }, 1683 | "date_end": "2018-03-02 14:51:07", 1684 | "district_name": "Голосеевский", 1685 | "advert_type_id": 1, 1686 | "advert_type_name": "продажа", 1687 | "is_show_building_no": 1, 1688 | "realty_type_parent_name": "Квартиры", 1689 | "user": { 1690 | "name": "Владимир", 1691 | "image": "", 1692 | "good_partner_top": "" 1693 | }, 1694 | "priceArr": { 1695 | "1": "60 000", 1696 | "2": "50 588", 1697 | "3": "1 680 672" 1698 | }, 1699 | "with_panoramas": 1 1700 | } 1701 | ``` 1702 | 1703 | ## Поиск объявлений 1704 | 1705 | Чтобы обратиться к DOM.RIA API search, Вам необходимо выполнить GET запрос такого вида: 1706 | 1707 | https://developers.ria.com/dom/search?api_key=YOUR_API_KEY&PARAMETERS 1708 | 1709 | или `curl -X GET "https://developers.ria.com/dom/search?api_key=YOUR_API_KEY&PARAMETERS" -H "accept: application/json"` 1710 | 1711 | Он состоит из: 1712 | 1713 | * **SEARCH** — название метода API, к которому Вы хотите обратиться. 1714 | 1715 | * **API_KEY** — ключ доступа. Для получения ключа доступа нужно зарегестрироватся на портале developers.ria.com 1716 | 1717 | * **PARAMETERS** — входные параметры, последовательность пар name=value, разделенных амперсандом. Список параметров указан выше. 1718 | 1719 | В ответ на такой запрос Вы получите ответ в формате JSON: 1720 | 1721 | ```json 1722 | { 1723 | "items": [ //id объявлений 1724 | 1725 | ], 1726 | "count": // количество 1727 | } 1728 | ``` 1729 | 1730 | Полное описание сервиса "Поиск объявлений" описанный с помощью стандарта DeFacto swagger 2.0 1731 | * [Квартир](http://swagger.ria.com/ui/?api=dom/apartments) 1732 | * [Домов](http://swagger.ria.com/ui/?api=dom/house#/) 1733 | * [Коммерческой недвижимости](http://swagger.ria.com/ui/?api=dom/commercial) 1734 | * [Офисов](http://swagger.ria.com/ui/?api=dom/offices) 1735 | * [Земельных участков](http://swagger.ria.com/ui/?api=dom/land) 1736 | * [Гаражей](http://swagger.ria.com/ui/?api=dom/garages) 1737 | 1738 | 1739 | **Пример** 1740 | 1741 | Допустим Вы ищете: 1742 | * Объект - Квартиры 1743 | * Тип недвижимости - квартира 1744 | * Операция - продажа 1745 | * Область - Киевская 1746 | * Город - Киев 1747 | * Район 1748 | * Оболонский 1749 | * Печерский 1750 | * Подольский 1751 | * Количество комнат от 1 до 3 1752 | * Общая площадь от 60 до 90 1753 | * Жилая площадь от 30 до 50 1754 | * Кухня от 4 до 9 1755 | * Кухня от 3 до 7 1756 | * Год постройки - не указан 1757 | * Цена от 20000 до 90000 1758 | * Цена за объект 1759 | * Тип валюты долары США 1760 | * Возможен торг 1761 | * Тип предложения - от посредника 1762 | 1763 | 1764 | В итоге мы получаем запрос такого [вида]: 1765 | 1766 | [https://developers.ria.com/auto/search?api_key=YOUR_API_KEY&category=1&realty_type=2&operation_type=1....](https://developers.ria.com/dom/search?category=1&realty_type=2&operation_type=1&state_id=10&city_id=10&district_id=15187&district_id=15189&district_id=15188&characteristic[209][from]=1&characteristic[209][to]=3&characteristic[214][from]=60&characteristic[214][to]=90&characteristic[216][from]=30&characteristic[216][to]=50&characteristic[218][from]=4&characteristic[218][to]=9&characteristic[227][from]=3&characteristic[227][to]=7&characteristic[443]=442&characteristic[234][from]=20000&characteristic[234][to]=90000&characteristic[242]=239&characteristic[273]=273&characteristic[1437]=1434&api_key=YOUR_API_KEY) 1767 | 1768 | или `curl -X GET "https://developers.ria.com/dom/search?category=1&realty_type=2&operation_type=1&state_id=10&city_id=10&district_id=15187&district_id=15189&district_id=15188&characteristic[209][from]=1&characteristic[209][to]=3&characteristic[214][from]=60&characteristic[214][to]=90&characteristic[216][from]=30&characteristic[216][to]=50&characteristic[218][from]=4&characteristic[218][to]=9&characteristic[227][from]=3&characteristic[227][to]=7&characteristic[443]=442&characteristic[234][from]=20000&characteristic[234][to]=90000&characteristic[242]=239&characteristic[273]=273&characteristic[1437]=1434&api_key=YOUR_API_KEY" -H "accept: application/json"` 1769 | 1770 | В случае успешного выполнения запроса по указанным параметрам результат будет со статусом **200 OK**. 1771 | 1772 | Пример успешного ответа: 1773 | 1774 | ```json 1775 | { 1776 | "items": [ 1777 | 13336044, 1778 | 14076392, 1779 | 13814523, 1780 | 14064249, 1781 | 13078930, 1782 | 13927706, 1783 | 13962022 1784 | ], 1785 | "count": 7 1786 | } 1787 | ``` 1788 | 1789 | 1790 | ## Методы для работы с областями, городами, районами 1791 | ### Области 1792 | Получить список областей можно отправив GET запрос по адресу [https://developers.ria.com/dom/states?api_key=YOUR_API_KEY](https://developers.ria.com/dom/states?api_key=YOUR_API_KEY). 1793 | Для получение информации на украинском языке нужно добавить параметр *lang_id=4* 1794 | 1795 | Полное описание сервиса "Методы для работы с областями, городами, районами" описанный с помощью стандарта DeFacto swagger 2.0 [здесь](http://swagger.ria.com/ui/?api=dom/states_cities_and_districts) 1796 | 1797 | Результат будет следующим: 1798 | ```json 1799 | [ 1800 | { 1801 | "lang_id": 2, 1802 | "stateID": 1, 1803 | "name": "Винницкая", 1804 | "eng_name": "vinnica", 1805 | "declension": "Винницкой области", 1806 | "center_declension": "Винницы", 1807 | "region_name": "Винница" 1808 | }, 1809 | { 1810 | "lang_id": 2, 1811 | "stateID": 18, 1812 | "name": "Волынская", 1813 | "eng_name": "luck", 1814 | "declension": "Волынской области", 1815 | "center_declension": "Луцка", 1816 | "region_name": "Луцк" 1817 | }, 1818 | { 1819 | "lang_id": 2, 1820 | "stateID": 11, 1821 | "name": "Днепропетровская", 1822 | "eng_name": "dnepropetrovsk", 1823 | "declension": "Днепропетровской области", 1824 | "center_declension": "Днепропетровска", 1825 | "region_name": "Днепропетровск" 1826 | }, 1827 | { 1828 | "lang_id": 2, 1829 | "stateID": 13, 1830 | "name": "Донецкая", 1831 | "eng_name": "doneck", 1832 | "declension": "Донецкой области", 1833 | "center_declension": "Донецка", 1834 | "region_name": "Донецк" 1835 | }, 1836 | { 1837 | "lang_id": 2, 1838 | "stateID": 2, 1839 | "name": "Житомирская", 1840 | "eng_name": "jitomir", 1841 | "declension": "Житомирской области", 1842 | "center_declension": "Житомира", 1843 | "region_name": "Житомир" 1844 | }, 1845 | { 1846 | "lang_id": 2, 1847 | "stateID": 22, 1848 | "name": "Закарпатская", 1849 | "eng_name": "ujgorod", 1850 | "declension": "Закарпатской области", 1851 | "center_declension": "Ужгорода", 1852 | "region_name": "Ужгород" 1853 | }, 1854 | { 1855 | "lang_id": 2, 1856 | "stateID": 14, 1857 | "name": "Запорожская", 1858 | "eng_name": "zaporoje", 1859 | "declension": "Запорожской области", 1860 | "center_declension": "Запорожья", 1861 | "region_name": "Запорожье" 1862 | }, 1863 | { 1864 | "lang_id": 2, 1865 | "stateID": 15, 1866 | "name": "Ивано-Франковская", 1867 | "eng_name": "ivano-frankovsk", 1868 | "declension": "Ивано-Франковской области", 1869 | "center_declension": "Ивано-Франковска", 1870 | "region_name": "Ивано-Франковск" 1871 | }, 1872 | { 1873 | "lang_id": 2, 1874 | "stateID": 10, 1875 | "name": "Киевская", 1876 | "eng_name": "kiev", 1877 | "declension": "Киевской области", 1878 | "center_declension": "Киева", 1879 | "region_name": "Киев" 1880 | }, 1881 | { 1882 | "lang_id": 2, 1883 | "stateID": 16, 1884 | "name": "Кировоградская", 1885 | "eng_name": "kirovograd", 1886 | "declension": "Кировоградской области", 1887 | "center_declension": "Кировограда", 1888 | "region_name": "Кировоград" 1889 | }, 1890 | { 1891 | "lang_id": 2, 1892 | "stateID": 17, 1893 | "name": "Луганская", 1894 | "eng_name": "lugansk", 1895 | "declension": "Луганской области", 1896 | "center_declension": "Луганска", 1897 | "region_name": "Луганск" 1898 | }, 1899 | { 1900 | "lang_id": 2, 1901 | "stateID": 5, 1902 | "name": "Львовская", 1903 | "eng_name": "lvov", 1904 | "declension": "Львовской области", 1905 | "center_declension": "Львова", 1906 | "region_name": "Львов" 1907 | }, 1908 | { 1909 | "lang_id": 2, 1910 | "stateID": 19, 1911 | "name": "Николаевская", 1912 | "eng_name": "nikolaev", 1913 | "declension": "Николаевской области", 1914 | "center_declension": "Николаева", 1915 | "region_name": "Николаев" 1916 | }, 1917 | { 1918 | "lang_id": 2, 1919 | "stateID": 12, 1920 | "name": "Одесская", 1921 | "eng_name": "odessa", 1922 | "declension": "Одесской области", 1923 | "center_declension": "Одессы", 1924 | "region_name": "Одесса" 1925 | }, 1926 | { 1927 | "lang_id": 2, 1928 | "stateID": 20, 1929 | "name": "Полтавская", 1930 | "eng_name": "poltava", 1931 | "declension": "Полтавской области", 1932 | "center_declension": "Полтавы", 1933 | "region_name": "Полтава" 1934 | }, 1935 | { 1936 | "lang_id": 2, 1937 | "stateID": 21, 1938 | "name": "Республика Крым", 1939 | "eng_name": "simferopol", 1940 | "declension": "Республики Крым", 1941 | "center_declension": "Симферополя", 1942 | "region_name": "Республика Крым" 1943 | }, 1944 | { 1945 | "lang_id": 2, 1946 | "stateID": 9, 1947 | "name": "Ровенская", 1948 | "eng_name": "rovno", 1949 | "declension": "Ровенской области", 1950 | "center_declension": "Ровно", 1951 | "region_name": "Ровно" 1952 | }, 1953 | { 1954 | "lang_id": 2, 1955 | "stateID": 8, 1956 | "name": "Сумская", 1957 | "eng_name": "sumiy", 1958 | "declension": "Сумской области", 1959 | "center_declension": "Сум", 1960 | "region_name": "Сумы" 1961 | }, 1962 | { 1963 | "lang_id": 2, 1964 | "stateID": 3, 1965 | "name": "Тернопольская", 1966 | "eng_name": "ternopol", 1967 | "declension": "Тернопольской области", 1968 | "center_declension": "Тернополя", 1969 | "region_name": "Тернополь" 1970 | }, 1971 | { 1972 | "lang_id": 2, 1973 | "stateID": 7, 1974 | "name": "Харьковская", 1975 | "eng_name": "harkov", 1976 | "declension": "Харьковской области", 1977 | "center_declension": "Харькова", 1978 | "region_name": "Харьков" 1979 | }, 1980 | { 1981 | "lang_id": 2, 1982 | "stateID": 23, 1983 | "name": "Херсонская", 1984 | "eng_name": "herson", 1985 | "declension": "Херсонской области", 1986 | "center_declension": "Херсона", 1987 | "region_name": "Херсон" 1988 | }, 1989 | { 1990 | "lang_id": 2, 1991 | "stateID": 4, 1992 | "name": "Хмельницкая", 1993 | "eng_name": "hmelnickiy", 1994 | "declension": "Хмельницкой области", 1995 | "center_declension": "Хмельницкого", 1996 | "region_name": "Хмельницкий" 1997 | }, 1998 | { 1999 | "lang_id": 2, 2000 | "stateID": 24, 2001 | "name": "Черкасская", 2002 | "eng_name": "cherkassiy", 2003 | "declension": "Черкасской области", 2004 | "center_declension": "Черкасс", 2005 | "region_name": "Черкассы" 2006 | }, 2007 | { 2008 | "lang_id": 2, 2009 | "stateID": 6, 2010 | "name": "Черниговская", 2011 | "eng_name": "chernigov", 2012 | "declension": "Черниговской области", 2013 | "center_declension": "Чернигова", 2014 | "region_name": "Чернигов" 2015 | }, 2016 | { 2017 | "lang_id": 2, 2018 | "stateID": 25, 2019 | "name": "Черновицкая", 2020 | "eng_name": "chernovciy", 2021 | "declension": "Черновицкой области", 2022 | "center_declension": "Черновцов", 2023 | "region_name": "Черновцы" 2024 | } 2025 | ``` 2026 | 2027 | ###Города 2028 | 2029 | Города зависят от областей, поэтому, чтобы получить их список, необходимо послать GET запрос по адресу `https://developers.ria.com/dom/cities/:stateId?api_key=YOUR_API_KEY`, где *stateId* - идентификатор области. 2030 | Для получение информации на украинском языке нужно добавить параметр *lang_id=4* 2031 | 2032 | Например, для Львовской области ([https://developers.ria.com/dom/cities/5?api_key=YOUR_API_KEY&lang_id=4](https://developers.ria.com/dom/cities/5?api_key=YOUR_API_KEY&lang_id=4) список городов будет следующим: 2033 | 2034 | ```json 2035 | [ 2036 | { 2037 | "lang_id": 4, 2038 | "cityID": 287, 2039 | "stateID": 5, 2040 | "name": "Борислав", 2041 | "eng": "borislav", 2042 | "declension": "" 2043 | }, 2044 | { 2045 | "lang_id": 4, 2046 | "cityID": 288, 2047 | "stateID": 5, 2048 | "name": "Броди", 2049 | "eng": "brodi", 2050 | "declension": "" 2051 | }, 2052 | { 2053 | "lang_id": 4, 2054 | "cityID": 289, 2055 | "stateID": 5, 2056 | "name": "Буськ", 2057 | "eng": "busk", 2058 | "declension": "" 2059 | }, 2060 | { 2061 | "lang_id": 4, 2062 | "cityID": 290, 2063 | "stateID": 5, 2064 | "name": "Городок", 2065 | "eng": "gorodok", 2066 | "declension": "" 2067 | }, 2068 | { 2069 | "lang_id": 4, 2070 | "cityID": 291, 2071 | "stateID": 5, 2072 | "name": "Дрогобич", 2073 | "eng": "drogobich", 2074 | "declension": "" 2075 | }, 2076 | { 2077 | "lang_id": 4, 2078 | "cityID": 292, 2079 | "stateID": 5, 2080 | "name": "Жидачів", 2081 | "eng": "jidachiv", 2082 | "declension": "" 2083 | }, 2084 | { 2085 | "lang_id": 4, 2086 | "cityID": 293, 2087 | "stateID": 5, 2088 | "name": "Жовква", 2089 | "eng": "jovkva", 2090 | "declension": "" 2091 | }, 2092 | { 2093 | "lang_id": 4, 2094 | "cityID": 294, 2095 | "stateID": 5, 2096 | "name": "Золочев", 2097 | "eng": "zolochev", 2098 | "declension": "" 2099 | }, 2100 | { 2101 | "lang_id": 4, 2102 | "cityID": 295, 2103 | "stateID": 5, 2104 | "name": "Кам'янка-Бузька", 2105 | "eng": "kam_yanka-buzka", 2106 | "declension": "" 2107 | }, 2108 | { 2109 | "lang_id": 4, 2110 | "cityID": 5, 2111 | "stateID": 5, 2112 | "name": "Львів", 2113 | "eng": "lviv", 2114 | "declension": "" 2115 | }, 2116 | { 2117 | "lang_id": 4, 2118 | "cityID": 297, 2119 | "stateID": 5, 2120 | "name": "Миколаїв", 2121 | "eng": "mikolayv", 2122 | "declension": "" 2123 | }, 2124 | { 2125 | "lang_id": 4, 2126 | "cityID": 646, 2127 | "stateID": 5, 2128 | "name": "Моршин", 2129 | "eng": "Morshun", 2130 | "declension": null 2131 | }, 2132 | { 2133 | "lang_id": 4, 2134 | "cityID": 298, 2135 | "stateID": 5, 2136 | "name": "Мостиська", 2137 | "eng": "mostiska", 2138 | "declension": "" 2139 | }, 2140 | { 2141 | "lang_id": 4, 2142 | "cityID": 632, 2143 | "stateID": 5, 2144 | "name": "Новий Розділ", 2145 | "eng": "noviy-rozdil", 2146 | "declension": "Новороздільский" 2147 | }, 2148 | { 2149 | "lang_id": 4, 2150 | "cityID": 299, 2151 | "stateID": 5, 2152 | "name": "Перемишляни", 2153 | "eng": "peremishlyani", 2154 | "declension": "" 2155 | }, 2156 | { 2157 | "lang_id": 4, 2158 | "cityID": 300, 2159 | "stateID": 5, 2160 | "name": "Пустомити", 2161 | "eng": "pustomiti", 2162 | "declension": "" 2163 | }, 2164 | { 2165 | "lang_id": 4, 2166 | "cityID": 301, 2167 | "stateID": 5, 2168 | "name": "Радехів", 2169 | "eng": "radehiv", 2170 | "declension": "" 2171 | }, 2172 | { 2173 | "lang_id": 4, 2174 | "cityID": 302, 2175 | "stateID": 5, 2176 | "name": "Самбір", 2177 | "eng": "sambir", 2178 | "declension": "" 2179 | }, 2180 | { 2181 | "lang_id": 4, 2182 | "cityID": 303, 2183 | "stateID": 5, 2184 | "name": "Сколе", 2185 | "eng": "skole", 2186 | "declension": "" 2187 | }, 2188 | { 2189 | "lang_id": 4, 2190 | "cityID": 304, 2191 | "stateID": 5, 2192 | "name": "Сокаль", 2193 | "eng": "sokal", 2194 | "declension": "" 2195 | }, 2196 | { 2197 | "lang_id": 4, 2198 | "cityID": 614, 2199 | "stateID": 5, 2200 | "name": "Соснівка", 2201 | "eng": "sosnovka", 2202 | "declension": null 2203 | }, 2204 | { 2205 | "lang_id": 4, 2206 | "cityID": 305, 2207 | "stateID": 5, 2208 | "name": "Старий Самбір", 2209 | "eng": "stariyi_sambir", 2210 | "declension": "" 2211 | }, 2212 | { 2213 | "lang_id": 4, 2214 | "cityID": 306, 2215 | "stateID": 5, 2216 | "name": "Стрий", 2217 | "eng": "striyi", 2218 | "declension": "" 2219 | }, 2220 | { 2221 | "lang_id": 4, 2222 | "cityID": 307, 2223 | "stateID": 5, 2224 | "name": "Трускавець", 2225 | "eng": "truskavec", 2226 | "declension": "" 2227 | }, 2228 | { 2229 | "lang_id": 4, 2230 | "cityID": 308, 2231 | "stateID": 5, 2232 | "name": "Турка", 2233 | "eng": "turka", 2234 | "declension": "" 2235 | }, 2236 | { 2237 | "lang_id": 4, 2238 | "cityID": 309, 2239 | "stateID": 5, 2240 | "name": "Червоноград", 2241 | "eng": "chervonograd", 2242 | "declension": "" 2243 | }, 2244 | { 2245 | "lang_id": 4, 2246 | "cityID": 310, 2247 | "stateID": 5, 2248 | "name": "Яворів", 2249 | "eng": "yavoriv", 2250 | "declension": "" 2251 | } 2252 | ] 2253 | ``` 2254 | 2255 | ###Районы 2256 | 2257 | Районы зависят от городов, поэтому, чтобы получить их список, необходимо послать GET запрос по адресу `https://developers.ria.com/dom/cities_districts/:city_id?api_key=YOUR_API_KEY`, где *city_id* - идентификатор города. 2258 | Для получение информации на украинском языке нужно добавить параметр *lang_id=4* 2259 | 2260 | Например, для города Львова ([https://developers.ria.com/dom/cities_districts/5?api_key=YOUR_API_KEY](https://developers.ria.com/dom/cities_districts/5?api_key=YOUR_API_KEY&) список районов будет следующим: 2261 | 2262 | ```json 2263 | [ 2264 | [ 2265 | { 2266 | "name": "Район", 2267 | "value": "" 2268 | }, 2269 | { 2270 | "city_id": 5, 2271 | "area_id": 15754, 2272 | "name": "Аеропорт", 2273 | "type": 1, 2274 | "value": 15754 2275 | }, 2276 | { 2277 | "city_id": 5, 2278 | "area_id": 15765, 2279 | "name": "Арсен", 2280 | "type": 1, 2281 | "value": 15765 2282 | }, 2283 | { 2284 | "city_id": 5, 2285 | "area_id": 15750, 2286 | "name": "Білогорща", 2287 | "type": 1, 2288 | "value": 15750 2289 | }, 2290 | { 2291 | "city_id": 5, 2292 | "area_id": 15771, 2293 | "name": "Бондарівка", 2294 | "type": 1, 2295 | "value": 15771 2296 | }, 2297 | { 2298 | "city_id": 5, 2299 | "area_id": 15751, 2300 | "name": "Виговського", 2301 | "type": 1, 2302 | "value": 15751 2303 | }, 2304 | { 2305 | "city_id": 5, 2306 | "area_id": 15763, 2307 | "name": "Винники", 2308 | "type": 1, 2309 | "value": 15763 2310 | }, 2311 | { 2312 | "city_id": 5, 2313 | "area_id": 15087, 2314 | "name": "Галицький", 2315 | "type": 1, 2316 | "value": 15087 2317 | }, 2318 | { 2319 | "city_id": 5, 2320 | "area_id": 15777, 2321 | "name": "Голоско", 2322 | "type": 1, 2323 | "value": 15777 2324 | }, 2325 | { 2326 | "city_id": 5, 2327 | "area_id": 15088, 2328 | "name": "Залізничний", 2329 | "type": 1, 2330 | "value": 15088 2331 | }, 2332 | { 2333 | "city_id": 5, 2334 | "area_id": 15778, 2335 | "name": "Замарстинів", 2336 | "type": 1, 2337 | "value": 15778 2338 | }, 2339 | { 2340 | "city_id": 5, 2341 | "area_id": 15779, 2342 | "name": "Збоїща", 2343 | "type": 1, 2344 | "value": 15779 2345 | }, 2346 | { 2347 | "city_id": 5, 2348 | "area_id": 15760, 2349 | "name": "Знесення", 2350 | "type": 1, 2351 | "value": 15760 2352 | }, 2353 | 2354 | { 2355 | "city_id": 5, 2356 | "area_id": 15767, 2357 | "name": "Новий Львів", 2358 | "type": 1, 2359 | "value": 15767 2360 | }, 2361 | { 2362 | "city_id": 5, 2363 | "area_id": 15773, 2364 | "name": "Новий Світ", 2365 | "type": 1, 2366 | "value": 15773 2367 | }, 2368 | { 2369 | "city_id": 5, 2370 | "area_id": 15768, 2371 | "name": "Пасіки", 2372 | "type": 1, 2373 | "value": 15768 2374 | }, 2375 | { 2376 | "city_id": 5, 2377 | "area_id": 15772, 2378 | "name": "Персеньківка", 2379 | "type": 1, 2380 | "value": 15772 2381 | }, 2382 | { 2383 | "city_id": 5, 2384 | "area_id": 15769, 2385 | "name": "Пироговка", 2386 | "type": 1, 2387 | "value": 15769 2388 | }, 2389 | 2390 | ....................... 2391 | 2392 | 2393 | { 2394 | "city_id": 5, 2395 | "area_id": 15775, 2396 | "name": "Ринок Південний", 2397 | "type": 1, 2398 | "value": 15775 2399 | }, 2400 | { 2401 | "city_id": 5, 2402 | "area_id": 15748, 2403 | "name": "Рясне", 2404 | "type": 1, 2405 | "value": 15748 2406 | }, 2407 | { 2408 | "city_id": 5, 2409 | "area_id": 15766, 2410 | "name": "Санта Барбара", 2411 | "type": 1, 2412 | "value": 15766 2413 | }, 2414 | { 2415 | "city_id": 5, 2416 | "area_id": 15753, 2417 | "name": "Сигнівка", 2418 | "type": 1, 2419 | "value": 15753 2420 | }, 2421 | { 2422 | "city_id": 5, 2423 | "area_id": 15090, 2424 | "name": "Сихівський", 2425 | "type": 1, 2426 | "value": 15090 2427 | }, 2428 | { 2429 | "city_id": 5, 2430 | "area_id": 15752, 2431 | "name": "Скнилів", 2432 | "type": 1, 2433 | "value": 15752 2434 | }, 2435 | { 2436 | "city_id": 5, 2437 | "area_id": 15747, 2438 | "name": "Снопківська", 2439 | "type": 1, 2440 | "value": 15747 2441 | }, 2442 | { 2443 | "city_id": 5, 2444 | "area_id": 15764, 2445 | "name": "ТЦ Іскра", 2446 | "type": 1, 2447 | "value": 15764 2448 | }, 2449 | { 2450 | "city_id": 5, 2451 | "area_id": 15091, 2452 | "name": "Франківський", 2453 | "type": 1, 2454 | "value": 15091 2455 | }, 2456 | { 2457 | "city_id": 5, 2458 | "area_id": 15745, 2459 | "name": "Цитадель", 2460 | "type": 1, 2461 | "value": 15745 2462 | }, 2463 | { 2464 | "city_id": 5, 2465 | "area_id": 15092, 2466 | "name": "Шевченківський", 2467 | "type": 1, 2468 | "value": 15092 2469 | } 2470 | ], 2471 | [ 2472 | { 2473 | "name": "Пригород", 2474 | "value": "" 2475 | }, 2476 | { 2477 | "city_id": 5, 2478 | "area_id": 7494, 2479 | "name": "Брюховичі", 2480 | "type": 2, 2481 | "value": 7494 2482 | }, 2483 | { 2484 | "city_id": 5, 2485 | "area_id": 15742, 2486 | "name": "Зимна Вода", 2487 | "type": 2, 2488 | "value": 15742 2489 | }, 2490 | { 2491 | "city_id": 5, 2492 | "area_id": 15743, 2493 | "name": "Малечковичі", 2494 | "type": 2, 2495 | "value": 15743 2496 | }, 2497 | { 2498 | "city_id": 5, 2499 | "area_id": 15741, 2500 | "name": "Сокільники", 2501 | "type": 2, 2502 | "value": 15741 2503 | } 2504 | ], 2505 | [ 2506 | { 2507 | "name": "Село", 2508 | "value": "" 2509 | }, 2510 | { 2511 | "city_id": 5, 2512 | "area_id": 7495, 2513 | "name": "Винники", 2514 | "type": 3, 2515 | "value": 7495 2516 | }, 2517 | { 2518 | "city_id": 5, 2519 | "area_id": 17513, 2520 | "name": "Липники", 2521 | "type": 3, 2522 | "value": 17513 2523 | }, 2524 | { 2525 | "city_id": 5, 2526 | "area_id": 7497, 2527 | "name": "Рудне", 2528 | "type": 3, 2529 | "value": 7497 2530 | } 2531 | ] 2532 | ] 2533 | ``` 2534 | 2535 | 2536 | ## Ошибки 2537 | 2538 | | Код ошибки | HTTP Status Code| Описание | 2539 | |:--------------------|:--------------------------|:------------:| 2540 | | API_KEY_MISSING | 403 | Ключ API не был указан. Подробнее об использовании ключа API см. В разделе о передаче API-интерфейса в API. | 2541 | | API_KEY_INVALID | 403 | Был указан недопустимый ключ API. Убедитесь, что ключ API прошел успешно, или зарегистрируйтесь для ключа API. | 2542 | | API_KEY_DISABLED | 403 | Ключ API был отключен администратором. Пожалуйста свяжитесь с нами для помощи. | 2543 | | API_KEY_UNAUTHORIZED | 403 | Предоставленный ключ API не авторизован для доступа к данной службе. Пожалуйста свяжитесь с нами для помощи. | 2544 | | API_KEY_UNVERIFIED | 403 | Ключ API не был подтвержден. Проверьте свой адрес электронной почты, чтобы подтвердить ключ API. Пожалуйста свяжитесь с нами для помощи. | 2545 | | HTTPS_REQUIRED | 400 | Запросы к этому API должны быть сделаны по протоколу HTTPS. Убедитесь, что используемый URL находится поверх HTTPS. | 2546 | | OVER_RATE_LIMIT | 429 | Ключ API превысил лимит запростов. Для получения дополнительной информации свяжитесь с нами. | 2547 | | NOT_FOUND | 404 | Не удалось найти API по данному URL-адресу. Проверьте свой URL. | 2548 | 2549 | 2550 | JSON Пример 2551 | ```javascript 2552 | { 2553 | "error": { 2554 | "code": "API_KEY_MISSING", 2555 | "message": "No api_key was supplied. Get one at https://developers.ria.com" 2556 | } 2557 | } 2558 | ``` 2559 | 2560 | XML 2561 | 2562 | ```xml 2563 | 2564 | 2565 | API_KEY_MISSING 2566 | No api_key was supplied. Get one at https://developers.ria.com 2567 | 2568 | 2569 | ``` 2570 | 2571 | CSV 2572 | ``` 2573 | Error Code,Error Message 2574 | API_KEY_MISSING,No api_key was supplied. Get one at https://developers.ria.com 2575 | ``` 2576 | HTML 2577 | 2578 | ```html 2579 | 2580 | 2581 |

API_KEY_MISSING

2582 |

No api_key was supplied. Get one at https://developers.ria.com

2583 | 2584 | 2585 | ``` 2586 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | The MIT License (MIT) 2 | 3 | Copyright (c) 2015 RIA.com 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | 23 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | # **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 4 | 5 | > 6 | > 7 | > Мы запускаем новую версию API с более широкими возможностями на [Developers.RIA.com](https://developers.ria.com). 8 | > Вам будут доступны все API AUTO.RIA, AUTO Search и AUTO Info, а также в дальнейшем API DOM.RIA и RIA.com. Документация по новой версии [здесь](https://github.com/ria-com/auto-ria-rest-api/blob/master/AUTO_RIA_API/README.md) 9 | > 10 | > Страница API 1.0 на Github будет поддерживаться до декабря 2017. 11 | > 12 | > Регистрируйтесь на [Developers.RIA.com](https://developers.ria.com) и используй все преимущества наших API. 13 | 14 | 15 | # [AUTO.RIA](https://github.com/ria-com/auto-ria-rest-api/tree/master/AUTO_RIA_API) 16 | # [DOM.RIA](https://github.com/ria-com/auto-ria-rest-api/tree/master/DOM_RIA_API) 17 | # [RIA.com](https://github.com/ria-com/auto-ria-rest-api/tree/master/RIA_com_API) 18 | 19 | 20 | 21 | 22 | # Тенденции на рынке б/у авто с REST API AUTO.RIA 23 | 24 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 25 | **Отслеживайте, анализируйте и прогнозируйте** 26 | 27 | Мы запускаем в свободное пользование **“Подсчёт средней цены”** — 28 | первый сервис, основанный на актуальных статистических данных **AUTO.RIA** (ежемесячно 10 тыс. опубликованных объявлений о продаже 7 800 марок авто, которые ежедневно собирают 8 млн. просмотров). 29 | 30 | Теперь вы можете: 31 | * узнавать актуальные средние цены автомобилей разных марок и моделей; 32 | * следить за изменениями цен в кратко- и долгосрочном периодах; 33 | * анализировать и прогнозировать изменения цен и спроса на автомобили; 34 | * размещать полученную информацию на вашем сайте.`*` 35 | 36 | ``` 37 | * Наличие ссылки на сайт AUTO.RIA с гиперссылкой на страницу https://AUTO.RIA.com, 38 | не закрытой для индексации поисковыми системами, является единственным 39 | обязательным требованием для использования сервиса. 40 | ``` 41 | 42 | Ознакомьтесь с технической документацией, чтобы получить доступ и экспортировать необходимую информацию в программу вашей компании. 43 | 44 | Благодарим за содействие в запуске сервиса “Подсчёт средней цены” ТОВ «Богдан–Авто Холдинг». 45 | 46 | Ваш AUTO.RIA, автосайт № 1 в Украине. 47 | 48 | 49 | # REST API сайта AUTO.RIA.com 50 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 51 | API возвращает данные в формате JSON. Формат данных в большинстве случаев стандартный - коллекция объектов с полями *name* (название объекта) и *value* (его идентификатор). 52 | 53 | Идентификатор любой сущности является целым числом. 54 | 55 | ## Содержание 56 | 57 | - [Подсчет средней цены](#user-content-Подсчет-средней-цены) 58 | + [Список поддерживаемых параметров](#user-content-Список-поддерживаемых-параметров) 59 | + [Формат данных в запросе](#user-content-Формат-данных-в-запросе) 60 | + [Формат данных в ответе](#user-content-Формат-данных-в-ответе) 61 | + [Примеры](#user-content-Примеры) 62 | - [Методы для работы с типами транспорта и кузова](#user-content-Методы-для-работы-с-типами-транспорта-и-кузова) 63 | + [Типы транспорта](#user-content-Типы-транспорта) 64 | + [Типы кузова](#user-content-Типы-кузова) 65 | - [Методы для работы с марками и моделями](#user-content-Методы-для-работы-с-марками-и-моделями) 66 | + [Марки](#user-content-Марки) 67 | + [Модели](#user-content-Модели) 68 | - [Методы для работы с областями и городами](#user-content-Методы-для-работы-с-областями-и-городами) 69 | + [Области](#user-content-Области) 70 | + [Города](#user-content-Города) 71 | - [Методы для работы с техническими характеристиками](#user-content-Методы-для-работы-с-техническими-характеристиками) 72 | + [Коробки передач](#user-content-Коробки-передач) 73 | + [Типы привода](#user-content-Типы-привода) 74 | + [Типы топлива](#user-content-Типы-топлива) 75 | + [Опции](#user-content-Опции) 76 | - [Цвета](#user-content-Цвета) 77 | - [Растаможка](#user-content-Растаможка) 78 | - [После ДТП](#user-content-После-ДТП) 79 | - [Взято в кредит](#user-content-Взято-в-кредит) 80 | - [Конфискат](#user-content-Конфискат) 81 | - [Не на ходу](#user-content-Не-на-ходу) 82 | 83 | ## Подсчет средней цены 84 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 85 | 86 | ### Список поддерживаемых параметров 87 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 88 | 89 | На данный момент поддерживаются следующие параметры: 90 | 91 | | Название | Параметр в строке запроса | Тип данных | 92 | |:--------------------|:--------------------------|:------------:| 93 | | [Тип транспорта](#user-content-Типы-транспорта) | main_category | `Number` | 94 | | [Тип кузова](#user-content-Типы-кузова) | body_id | `Number` | 95 | | [Марка](#user-content-Марки) | marka_id | `Number` | 96 | | [Модель](#user-content-Модели) | model_id | `Number` | 97 | | Год выпуска | yers | `Number[]` | 98 | | [Коробка передач](#user-content-Коробки-передач) | gear_id | `Number[]` | 99 | | [Тип топлива](#user-content-Типы-топлива) | fuel_id | `Number[]` | 100 | | [Тип привода](#user-content-Типы-топлива) | drive_id | `Number` | 101 | | Объем двигателя | engineVolume | `Number` | 102 | | [Опции](#user-content-Опции) | options | `Number[]` | 103 | | Пробег | raceInt | `Number[]` | 104 | | Количество дверей | door | `Number` | 105 | | [Область](#user-content-Области) | state_id | `Number` | 106 | | [Город](#user-content-Города) | city_id | `Number` | 107 | | Грузоподъемность | carrying | `Number` | 108 | | Количество мест | seats | `Number` | 109 | | [Цвет](#user-content-Цвета) | color_id | `Number` | 110 | | [Растаможка](#user-content-Растаможка) | custom | `Number` | 111 | | [После ДТП](#user-content-После-ДТП) | damage | `Number`| 112 | | [Взято в кредит](#user-content-Взято-в-кредит) | under_credit | `Number` | 113 | | [Конфискат](#user-content-Конфискат) | confiscated_car | `Number` | 114 | | [Не на ходу](#user-content-Не-на-ходу) |onRepairParts |`Number`| 115 | 116 | ### Формат данных в запросе 117 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 118 | Все параметры описанные в таблице поддерживаемых параметров должны передаватся в виде чисел. Исключениями являются только параметры - *год выпуска*. *пробег*, *опции* и *коробка передач*. 119 | 120 | Если передать массив в параметре *коробка передач*, то это будет интерпретироваться как поиск коробок передач с логическим оператором *ИЛИ*. Т.е. `http://api.auto.ria.com/average?marka_id=9&model_id=31612&gear_id=1&gear_id=2` - выберет для подсчета все **BMW 318** с автоматическими и ручными коробками передач. Аналогично и с параметром *тип топлива*, например: `http://api.auto.ria.com/average?marka_id=9&model_id=31887&yers=2014&fuel_id=1&fuel_id=2` - выберет для подсчета все **BMW 520 2014 года** с дизельными и бензиновыми двигателями. 121 | 122 | Если передать массив в параметре *год выпуска* или *пробег* это будет интерпретироваться как диапазон значений. Например, `http://api.auto.ria.com/average?raceInt=10&raceInt=100` - выберет для подсчета средней цены все объявления с пробегом от 10 до 100 тыс. км. 123 | 124 | Если передать массив значений в параметре *опции* это будет интерпретироваться как поиск опций с логическим оператором "И". Т.е. `http://api.auto.ria.com/average?auto_options=217&auto_options=463` выберет для подсчета все объявления, у которых есть опция *ABS* **И** *Галогенные фары*. 125 | 126 | ### Формат данных в ответе 127 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 128 | 129 | В случае успешного подсчета средней цены по указанным параметрам результат будет со статусом **200 OK**. 130 | 131 | Пример успешного ответа: 132 | ```javascript 133 | { 134 | total: 17, 135 | arithmeticMean: 16305.882352941177, 136 | interQuartileMean: 8483.333333333334, 137 | percentiles: { 138 | 1.0: 1944, 139 | 5.0: 2520, 140 | 25.0: 3500, 141 | 50.0: 8000, 142 | 75.0: 23500, 143 | 95.0: 53539.999999999985, 144 | 99.0: 64868 145 | }, 146 | prices: [ 147 | 67700, 148 | 27000, 149 | 3000, 150 | 23500, 151 | 3500, 152 | 8100, 153 | 10000, 154 | 3500, 155 | 2700, 156 | 8000, 157 | 11000, 158 | 45800, 159 | 50000, 160 | 1800, 161 | 4350, 162 | 4400, 163 | 2850 164 | ], 165 | classifieds: [ 166 | 14663610, 167 | 14226353, 168 | 14138132, 169 | 13969588, 170 | 14697569, 171 | 13386778, 172 | 13279188, 173 | 14555863, 174 | 14754932, 175 | 14816842, 176 | 14664706, 177 | 13873344, 178 | 14681607, 179 | 14772056, 180 | 14059841, 181 | 14290096, 182 | 14890250 183 | ] 184 | } 185 | ``` 186 | Расшифровка параметров: 187 | - *total* - общее количество объявлений, учавствующих в подсчете. 188 | - *arithmeticMean* - [среднее арифметическое](https://ru.wikipedia.org/wiki/%D0%A1%D1%80%D0%B5%D0%B4%D0%BD%D0%B5%D0%B5_%D0%B0%D1%80%D0%B8%D1%84%D0%BC%D0%B5%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B5). 189 | - *interQuartileMean* - среднее арифметическое из значений, находящихся между первым и четвертым [квантилем](https://ru.wikipedia.org/wiki/%D0%9A%D0%B2%D0%B0%D0%BD%D1%82%D0%B8%D0%BB%D1%8C). Грубо говоря, это среднее арифметическое без учета 25% самых маленьких и самых больших значений. 190 | - *percentiles* - значения [процентилей](https://ru.wikipedia.org/wiki/%D0%9A%D0%B2%D0%B0%D0%BD%D1%82%D0%B8%D0%BB%D1%8C#.D0.9F.D0.B5.D1.80.D1.86.D0.B5.D0.BD.D1.82.D0.B8.D0.BB.D1.8C). Т.е. для данного примера 25% всех объявлений имеют цену ниже $3500. 191 | - *prices* - список цен, которые учавствовали в подсчете средней цены. Размер ограничен 1000 элементов. 192 | - *classifieds* - идентификаторы объявлений, к которым принадлежат цены соответственно. Размер ограничен 1000 элементов. 193 | 194 | Если по каким-либо причинам не удалось подсчитать среднюю цену, ответ будет иметь статус **400 Bad Request**, а тело ответа будет содержать следующее: 195 | ```javascript 196 | { "message": "Not Enough Data" } 197 | ``` 198 | 199 | ### Примеры 200 | 201 | Средняя цена по BMW X5 с пробегом от 10 до 100 тыс. км. - [http://api.auto.ria.com/average?marka_id=9&model_id=96&raceInt=10&raceInt=100](http://api.auto.ria.com/average?marka_id=9&model_id=96&raceInt=10&raceInt=100). 202 | 203 | 204 | Средняя цена для Honda Accord в Киеве - [http://api.auto.ria.com/average?marka_id=28&model_id=262&city_id=9](http://api.auto.ria.com/average?marka_id=28&model_id=262&city_id=9) 205 | 206 | ## Методы для работы с типами транспорта и кузова 207 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 208 | 209 | ### Типы транспорта 210 | 211 | Получить список типов транспорта можно отправив GET запрос на адрес [http://api.auto.ria.com/categories](http://api.auto.ria.com/categories). Результат будет примерно следующим: 212 | ```javascript 213 | [ 214 | { name: "Легковые", value: 1 }, 215 | { name: "Мото", value: 2 }, 216 | { name: "Водный транспорт", value: 3 }, 217 | { name: "Спецтехника", value: 4 }, 218 | { name: "Прицеп", value: 5 }, 219 | { name: "Грузовик", value: 6 }, 220 | { name: "Автобус", value: 7 }, 221 | { name: "Автодом", value: 8 }, 222 | { name: "Воздушный транспорт", value: 9 } 223 | ] 224 | ``` 225 | 226 | ### Типы кузова 227 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 228 | 229 | Типы кузова зависят от типов транспорта. Поэтому для того, чтобы получить список типов кузова необходимо отправить GET запрос на адрес `http://api.auto.ria.com/categories/:categoryId/bodystyles`, где *categoryId* - идентификатор типа транспорта. 230 | 231 | Например, для легковых автомобилей ([http://api.auto.ria.com/categories/1/bodystyles](http://api.auto.ria.com/categories/1/bodystyles)), результат будет следующим: 232 | ```javascript 233 | [ 234 | { name: "Седан", value: 3 }, 235 | { name: "Внедорожник / Кроссовер", value: 5 }, 236 | { name: "Минивэн", value: 8 }, 237 | { name: "Хэтчбек", value: 4 }, 238 | { name: "Универсал", value: 2 }, 239 | { name: "Купе", value: 6 }, 240 | { name: "Легковой фургон (до 1,5 т)", value: 254 }, 241 | { name: "Кабриолет", value: 7 }, 242 | { name: "Пикап", value: 9 }, 243 | { name: "Лимузин", value: 252 }, 244 | { name: "Другой", value: 28 } 245 | ] 246 | ``` 247 | 248 | Также типы кузова могут быть разделены на группы. Это актуально для спецтехники. Поэтому существует способ получить сгруппированные типы кузова отправив GET запрос по адресу `http://api.auto.ria.com/categories/:categoryId/bodystyles/_group`, где *categoryId* - идентификатор типа транспорта. 249 | 250 | Например, для мотоциклов ([http://api.auto.ria.com/categories/2/bodystyles/_group](http://api.auto.ria.com/categories/2/bodystyles/_group)), результат будет следующим: 251 | ```javascript 252 | [ 253 | [ 254 | { name: "Мопеды", value: 58 }, 255 | { name: "Скутер / Мотороллер", value: 11 }, 256 | { name: "Макси-скутер", value: 12 } 257 | ], 258 | [ 259 | { name: "Мотоциклы", value: 13 }, 260 | { name: "Мотоцикл Без обтекателей (Naked bike)", value: 15 }, 261 | { name: "Мотоцикл Внедорожный (Enduro)", value: 21 }, 262 | { name: "Мотоцикл Кастом", value: 30 }, 263 | { name: "Мотоцикл Классик", value: 14 }, 264 | { name: "Мотоцикл Кросс", value: 19 }, 265 | { name: "Мотоцикл Круизер", value: 24 }, 266 | { name: "Мотоцикл Многоцелевой (All-round)", value: 25 }, 267 | { name: "Мотоцикл с коляской", value: 29 }, 268 | { name: "Спортбайк", value: 18 }, 269 | { name: "Мотоцикл Спорт-туризм", value: 17 }, 270 | { name: "Мотоцикл Супермото (Motard)", value: 22 }, 271 | { name: "Мотоцикл Триал", value: 20 }, 272 | { name: "Мотоцикл Туризм", value: 16 }, 273 | { name: "Мотоцикл Чоппер", value: 23 } 274 | ], 275 | [ 276 | { name: "Мини мотоциклы", value: 31 }, 277 | { name: "Мини спорт", value: 32 }, 278 | { name: "Мини крос (Питбайк)", value: 33 } 279 | ], 280 | { name: "Трицикл", value: 34 }, 281 | { name: "Трайк", value: 57 }, 282 | [ 283 | { name: "Квадроциклы", value: 35 }, 284 | { name: "Квадроцикл детский", value: 36 }, 285 | { name: "Квадроцикл спортивный", value: 39 }, 286 | { name: "Квадроцикл утилитарный", value: 41 }, 287 | { name: "Мотовездеход", value: 42 }, 288 | { name: "Вездеход-амфибия", value: 43 }, 289 | { name: "Гольф-кар", value: 44 }, 290 | { name: "Картинг", value: 45 } 291 | ], 292 | { name: "Снегоход", value: 46 }, 293 | { name: "Другое", value: 56 } 294 | ] 295 | ``` 296 | 297 | Формат данных при этом отличается от обычного - это коллекция объектов, в которой есть другие коллекции. Группа типов кузовов всегда начинается с её названия. Например, в группу *Квадроциклы* входят типы кузовов *Квадроцикл детский*, *Квадроцикл спортивный*, *Квадроцикл утилитарный*, *Мотовездеход* и т.д. 298 | 299 | Также, при необходимости, можно получиться просто весь список типов кузовов, послав GET запрос по адресу [http://api.auto.ria.com/bodystyles](http://api.auto.ria.com/bodystyles). 300 | 301 | ## Методы для работы с марками и моделями 302 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 303 | 304 | ### Марки 305 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 306 | 307 | Марки зависят от типов транспорта. Поэтому для того, чтобы получить список марок необходимо отправить GET запрос по адресу `http://api.auto.ria.com/categories/:categoryId/marks`, где *categoryId* - идентификатор типа транспорта. 308 | 309 | Например, для легковых автомобилей ([http://api.auto.ria.com/categories/1/marks](http://api.auto.ria.com/categories/1/marks)), результат будет следующим: 310 | ```javascript 311 | [ 312 | { name: "Acura", value: 98 }, 313 | { name: "Adler", value: 2396 }, 314 | { name: "Aixam", value: 2 }, 315 | { name: "Alfa Romeo", value: 3 }, 316 | { name: "Alpine", value: 100 }, 317 | { name: "Altamarea", value: 3988 }, 318 | { name: "Aro", value: 101 }, 319 | { name: "Artega", value: 3105 }, 320 | { name: "Asia", value: 4 }, 321 | { name: "Aston Martin", value: 5 }, 322 | { name: "Audi", value: 6 }, 323 | { name: "Austin", value: 7 }, 324 | { name: "Autobianchi", value: 102 } 325 | ... 326 | ] 327 | ``` 328 | 329 | ### Модели 330 | 331 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 332 | 333 | Модели зависят от типов транспорта и марок. Следовательно список марок можно получить по адресу `http://api.auto.ria.com/categories/:categoryId/marks/:markId/models`, где *categoryId* - идентификатор типа транспорта а *markId* - идентификатор марки. 334 | 335 | Например, для мотоциклов BMW ([http://api.auto.ria.com/categories/2/marks/9/models](http://api.auto.ria.com/categories/2/marks/9/models)), список моделей будет следующим: 336 | ```javascript 337 | [ 338 | { name: "Adventure", value: 25290 }, 339 | { name: "C", value: 25291 }, 340 | { name: "CS", value: 25292 }, 341 | { name: "DKW", value: 28318 }, 342 | { name: "F", value: 25293 }, 343 | { name: "G", value: 29468 }, 344 | { name: "GS", value: 25295 }, 345 | { name: "HP", value: 38148 }, 346 | { name: "Independent", value: 25297 }, 347 | { name: "K", value: 25298 }, 348 | { name: "LT", value: 25299 }, 349 | { name: "R", value: 25300 }, 350 | { name: "RS", value: 32736 }, 351 | { name: "RT", value: 25301 }, 352 | { name: "S", value: 25302 }, 353 | { name: "X", value: 42030 } 354 | ] 355 | ``` 356 | 357 | Модели, также как и типы кузовов, могут быть сгруппированы. Чтобы получить такой список, необходимо отправить запрос по адресу `http://api.auto.ria.com/categories/:categoryId/marks/:markId/models/_group`, где *categoryId* - идентификатор типа транспорта а *markId* - идентификатор марки. 358 | 359 | Например, для легковых автомобилей BMW ([http://api.auto.ria.com/categories/1/marks/9/models/_group](http://api.auto.ria.com/categories/1/marks/9/models/_group)), список моделей будет следующим: 360 | ```javascript 361 | [ 362 | [ 363 | { name: "1 Series (все)", value: 2161 }, 364 | { name: "116", value: 34670 }, 365 | { name: "118", value: 34671 }, 366 | { name: "120", value: 34672 }, 367 | { name: "123", value: 34673 }, 368 | { name: "125", value: 34674 }, 369 | { name: "130", value: 34675 }, 370 | { name: "135", value: 34676 } 371 | ], 372 | [ 373 | { name: "3 Series (все)", value: 3219 }, 374 | { name: "3 Series GT", value: 43029 }, 375 | { name: "315", value: 37454 }, 376 | { name: "316", value: 30851 }, 377 | { name: "318", value: 31612 }, 378 | { name: "320", value: 31611 }, 379 | { name: "321", value: 37389 }, 380 | { name: "323", value: 34677 }, 381 | { name: "324", value: 30687 }, 382 | { name: "325", value: 29713 }, 383 | { name: "326", value: 44061 }, 384 | { name: "328", value: 31661 }, 385 | { name: "330", value: 34678 }, 386 | { name: "335", value: 34679 }, 387 | { name: "340", value: 35568 } 388 | ], 389 | ... 390 | { name: "Alpina", value: 906 }, 391 | { name: "Dixi", value: 33383 }, 392 | { name: "I3", value: 44838 }, 393 | { name: "I8", value: 44537 }, 394 | { name: "Isetta", value: 32380 }, 395 | { name: "Z1", value: 97 }, 396 | { name: "Z3", value: 98 }, 397 | { name: "Z4", value: 99 }, 398 | { name: "Z8", value: 100 } 399 | ] 400 | ``` 401 | Формат данных такой же как и в случае с типа кузова - коллекция объектов, в которой могут быть другие объекты. Группа моделей всегда начинается с её названия. 402 | 403 | Также, при необходимости, можно просто получить список всех моделей, отправив GET запрос по адресу [http://api.auto.ria.com/models](http://api.auto.ria.com/models). 404 | 405 | ## Методы для работы с областями и городами 406 | 407 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 408 | 409 | ### Области 410 | 411 | Получить список областей можно отправив GET запрос по адресу [http://api.auto.ria.com/states](http://api.auto.ria.com/states). 412 | 413 | Результат будет следующим: 414 | ```javascript 415 | [ 416 | { name: "Винницкая", value: 1 }, 417 | { name: "Волынская", value: 18 }, 418 | { name: "Днепропетровская", value: 11 }, 419 | { name: "Донецкая", value: 13 }, 420 | { name: "Житомирская", value: 2 }, 421 | { name: "Закарпатская", value: 22 }, 422 | { name: "Запорожская", value: 14 }, 423 | { name: "Ивано-Франковская", value: 15 }, 424 | { name: "Киевская", value: 10 }, 425 | { name: "Кировоградская", value: 16 }, 426 | { name: "Луганская", value: 17 }, 427 | { name: "Львовская", value: 5 }, 428 | { name: "Николаевская", value: 19 }, 429 | { name: "Одесская", value: 12 }, 430 | { name: "Полтавская", value: 20 }, 431 | { name: "Республика Крым", value: 21 }, 432 | { name: "Ровенская", value: 9 }, 433 | { name: "Сумская", value: 8 }, 434 | { name: "Тернопольская", value: 3 }, 435 | { name: "Харьковская", value: 7 }, 436 | { name: "Херсонская", value: 23 }, 437 | { name: "Хмельницкая", value: 4 }, 438 | { name: "Черкасская", value: 24 }, 439 | { name: "Черниговская", value: 6 }, 440 | { name: "Черновицкая", value: 25 } 441 | ] 442 | ``` 443 | 444 | ### Города 445 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 446 | 447 | Города зависят от областей, поэтому, чтобы получить их список, необходимо послать GET запрос по адресу `http://api.auto.ria.com/states/:stateId/cities`, где *stateId* - идентификатор области. 448 | 449 | Например, для Винницкой области ([http://api.auto.ria.com/states/1/cities](http://api.auto.ria.com/states/1/cities)) список городов будет следующим: 450 | ```javascript 451 | [ 452 | { name: "Винница", value: 1 }, 453 | { name: "Жмеринка", value: 27 }, 454 | { name: "Казатин", value: 30 }, 455 | { name: "Крыжополь", value: 31 }, 456 | { name: "Липовец", value: 32 }, 457 | { name: "Литин", value: 33 }, 458 | { name: "Могилев-Подольский", value: 34 }, 459 | { name: "Мурованые Куриловцы", value: 35 }, 460 | { name: "Немиров", value: 36 }, 461 | { name: "Оратов", value: 37 }, 462 | { name: "Песчанка", value: 38 }, 463 | { name: "Погребище", value: 39 }, 464 | { name: "Теплик", value: 40 }, 465 | { name: "Тывров", value: 41 }, 466 | { name: "Томашполь", value: 42 }, 467 | { name: "Тростянец", value: 43 }, 468 | { name: "Тульчин", value: 44 }, 469 | { name: "Хмельник", value: 45 }, 470 | { name: "Черновцы", value: 46 }, 471 | { name: "Чечельник", value: 47 }, 472 | { name: "Шаргород", value: 48 }, 473 | { name: "Ямполь", value: 49 }, 474 | { name: "Бар", value: 597 }, 475 | { name: "Бершадь", value: 599 }, 476 | { name: "Гайсин", value: 602 }, 477 | { name: "Ильинцы", value: 603 }, 478 | { name: "Калиновка", value: 604 }, 479 | { name: "Гнивань", value: 609 }, 480 | { name: "Ладыжин", value: 644 } 481 | ] 482 | ``` 483 | 484 | ## Методы для работы с техническими характеристиками 485 | 486 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 487 | 488 | ### Коробки передач 489 | 490 | Коробки передач зависят от типа транспорта, поэтому, чтобы получить их список, необходимо послать GET запрос по адресу `http://api.auto.ria.com/categories/:categoryId/gearboxes`, где *categoryId* - идентификатор типа транспорта. 491 | 492 | Например, список коробок передач для мотоциклов ([http://api.auto.ria.com/categories/2/gearboxes](http://api.auto.ria.com/categories/2/gearboxes)) будет выглядеть следующим образом: 493 | ```javascript 494 | [ 495 | { name: "Ручная / Механика", value: 1 }, 496 | { name: "Автомат", value: 2 }, 497 | { name: "Типтроник", value: 3 }, 498 | { name: "Адаптивная", value: 4 }, 499 | { name: "Вариатор", value: 5 } 500 | ] 501 | ``` 502 | 503 | ### Типы привода 504 | 505 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 506 | 507 | Типы привода также зависят от типа транспорта, поэтому, чтобы получить их список, необходимо плсать GET запрос по адресу `http://api.auto.ria.com/categories/:categoryId/driverTypes`, где *categoryId* - идентификатор типа транспорта. 508 | 509 | Например, список типов привода для мотоциклов ([http://api.auto.ria.com/categories/2/driverTypes](http://api.auto.ria.com/categories/2/driverTypes)) выглядит следующим образом: 510 | ```javascript 511 | [ 512 | { name: "Кардан", value: 4 }, 513 | { name: "Ремень", value: 5 }, 514 | { name: "Цепь", value: 6 } 515 | ] 516 | ``` 517 | 518 | ### Типы топлива 519 | 520 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 521 | 522 | Типы топлива можно получить отправив GET запрос по адресу [http://api.auto.ria.com/fuels](http://api.auto.ria.com/fuels). Ответ будет выглядеть так: 523 | ```javascript 524 | [ 525 | { name: "Бензин", value: 1 }, 526 | { name: "Дизель", value: 2 }, 527 | { name: "Газ", value: 3 }, 528 | { name: "Газ/бензин", value: 4 }, 529 | { name: "Гибрид", value: 5 }, 530 | { name: "Электро", value: 6 }, 531 | { name: "Другое", value: 7 }, 532 | { name: "Газ метан", value: 8 }, 533 | { name: "Газ пропан-бутан", value: 9 } 534 | ] 535 | ``` 536 | 537 | ### Опции 538 | 539 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 540 | 541 | Опции зависят от типа транспорта. Получить их список можно отправив GET запрос по адресу `http://api.auto.ria.com/categories/:categoryId/options`, где *categoryId* - идентификатор типа транспорта. 542 | 543 | Например, список опций для легковых автомобилей ([http://api.auto.ria.com/categories/1/options](http://api.auto.ria.com/categories/1/options)) будет выглядеть примерно так: 544 | ```javascript 545 | [ 546 | { name: "ABD", value: 354 }, 547 | { name: "ABS", value: 217 }, 548 | { name: "ESP", value: 459 }, 549 | { name: "Галогенные фары", value: 463 }, 550 | { name: "Замок на КПП", value: 481 }, 551 | { name: "Иммобилайзер", value: 225 }, 552 | { name: "Пневмоподвеска", value: 442 }, 553 | { name: "Подушка безопасности (Airbag)", value: 211 }, 554 | { name: "Серворуль", value: 485 }, 555 | { name: "Сигнализация", value: 303 }, 556 | ... 557 | ] 558 | ``` 559 | 560 | ## Цвета 561 | 562 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 563 | 564 | Получить список всех цветов можно, если отправить GET запрос по адресу [http://api.auto.ria.com/colors](http://api.auto.ria.com/colors). Результат будет седующим: 565 | ```javascript 566 | [ 567 | { name: "Бежевый", value: 1 }, 568 | { name: "Черный", value: 2 }, 569 | { name: "Синий", value: 3 }, 570 | { name: "Бронзовый", value: 4 }, 571 | { name: "Коричневый", value: 5 }, 572 | { name: "Золотой", value: 6 }, 573 | { name: "Зеленый", value: 7 }, 574 | { name: "Серый", value: 8 }, 575 | { name: "Апельсин", value: 9 }, 576 | { name: "Магнолии", value: 10 }, 577 | { name: "Розовый", value: 11 }, 578 | { name: "Фиолетовый", value: 12 }, 579 | { name: "Красный", value: 13 }, 580 | { name: "Серебряный", value: 14 }, 581 | { name: "Белый", value: 15 }, 582 | { name: "Желтый", value: 16 }, 583 | { name: "Голубой", value: 17 }, 584 | { name: "Вишнёвый", value: 18 }, 585 | { name: "Сафари", value: 19 }, 586 | { name: "Гранатовый", value: 20 }, 587 | { name: "Асфальт", value: 21 } 588 | ] 589 | ``` 590 | 591 | ## Растаможка ## 592 | 593 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 594 | 595 | Параметр растаможки может принимать только два значения: `1` - нерастаможенный и `0` - растаможенный. 596 | 597 | 598 | ## После ДТП ## 599 | 600 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 601 | 602 | Данный параметр принимает следующие значения: 603 | `1` - объявления после ДТП 604 | `0` - остальные объявления 605 | 606 | ## Взято в кредит ## 607 | 608 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 609 | 610 | Данный параметр может принимать следующие значения: 611 | `1` - объявления взятые в кредит 612 | `0` - остальные объявления 613 | 614 | ## Конфискат ## 615 | 616 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 617 | 618 | Данный параметр может принимать следующие значения: 619 | `1` - только конфискованные объявления 620 | `0` - только неконфискованные объявления 621 | 622 | ## Не на ходу ## 623 | 624 | Данный параметр может принимать следующие значения: 625 | `1` - только объявления не на ходу 626 | `0` - только объявления на ходу 627 | -------------------------------------------------------------------------------- /RIA_com_API/README.md: -------------------------------------------------------------------------------- 1 | # RIA.com 2 | 3 | **Для перегляду актуальної документації перейдіть у розділ ["Документація"](https://developers.ria.com/docs/)** 4 | 5 | 6 | Мы начали создавать новые персонализированные API, которые помогут Вам управлять всеми Вашими обьявлениями на RIA.com 7 | 8 | При этом, нет необходимости открывать много вкладок, теперь все API доступны в одной админ-панели. 9 | Зарегистрируйтесь или авторизируйтесь на [myAPI.RIA.com](http://myapi.ria.com/), чтобы использовать персонализированные API. 10 | По умолчанию все права на доступ к сервисам не активны, что бы активировать нужный Вам сервис перейдите во вкладку "[Мої Дозволи](http://myapi.ria.com/my/credentials)" 11 | 12 | Все методы и данные описаные с помощью стандарта DeFacto swagger 2.0 13 | 14 | 15 | ### Сервис корзина заказов 16 | 17 | [Полное описание сервиса "Корзина заказов"](http://swagger.ria.com/ui/?api=/ria/basket#/basket) 18 | 19 | 20 | 21 | #### Перечень статусов заказов 22 | 23 | Что бы получить список типов статусов нужно отправив GET запрос на адрес [https://developers.ria.com/ria/basket/status?api_key=YOUR_API_KEY](https://developers.ria.com/ria/basket/status?api_key=YOUR_API_KEY). Результат будет примерно следующим: 24 | 25 | ` curl -X GET https://developers.ria.com/ria/basket/status?api_key=YOUR_API_KEY` 26 | 27 | ```javascript 28 | { 29 | "status": true, 30 | "data": [ 31 | { 32 | "id": 0, 33 | "name": "Новые" 34 | }, 35 | { 36 | "id": 1, 37 | "name": "Выполненные" 38 | }, 39 | { 40 | "id": 2, 41 | "name": "Невыполненные" 42 | }, 43 | { 44 | "id": 6, 45 | "name": "Удаленные" 46 | }, 47 | { 48 | "id": 4, 49 | "name": "Все" 50 | } 51 | ] 52 | } 53 | ``` 54 | 55 | #### Перечень заказов 56 | 57 | Что бы получить список заказов нужно отправив GET запрос на адрес [https://developers.ria.com/ria/basket/orders/?api_key=YOUR_API_KEY](https://developers.ria.com/ria/basket/orders/?api_key=YOUR_API_KEY). 58 | 59 | ` curl -X GET https://developers.ria.com/ria/basket/orders?api_key=YOUR_API_KEY` 60 | 61 | Результат будет примерно следующим: 62 | 63 | ```javascript 64 | { 65 | "status":true, 66 | "total":2, 67 | "orders":[ 68 | { 69 | "order_id":21, // id заказа 70 | "status":6, // Статус "Удаленные" 71 | "total_order_sum":100, // Общая сумма заказа 72 | "created_at":"2017-04-06 16:35:31", // Время создания 73 | "recipient":{ 74 | "user_id":000000, // id пользователя 75 | "name":"Андрій Сергійович", 76 | "email":"mail@gmail.com", 77 | "phone":"......" // Телефон 78 | }, 79 | "delivery":{ // Доставка 80 | "state_id":1, // id Области 81 | "city_id":1, // id Города 82 | "address":"Винницкая область, Винница", 83 | "service":"DHL" // Служба доставки 84 | }, 85 | "items":[ 86 | { 87 | "adv_id":3612261, // id объявления 88 | "name":"Детали двигателя Головка блока Легковой Audi A3 Cabrio v2 v3", 89 | "price":100, // Цена 90 | "count":1, // Количество 91 | "note":"" // Заметки 92 | "vendor_code": "" // Код поставщика 93 | 94 | } 95 | ] 96 | }, 97 | ... 98 | ] 99 | ``` 100 | #### Изменение статуса заказа 101 | 102 | Что бы изменить статус заказа нужно отправить PUT запрос на адрес` curl -X PUT "https://developers.ria.com/ria/basket/orders?user_id=*id*&order_id=*id*&api_key=YOUR_API_KEY" -H "accept: application/json" -H "content-type: application/json" -d "{ \"status\": 0}"` 103 | , где *user_id* - id пользователя, *order_id* - id заказа, *status_id* - id статуса заказа, 104 | 105 | 106 | 107 | Ответ будет следующим: 108 | ```javascript 109 | { 110 | "status": true 111 | } 112 | ``` 113 | 114 | 115 | ## Ошибки 116 | 117 | | Код ошибки | HTTP Status Code| Описание | 118 | |:--------------------|:--------------------------|:------------:| 119 | | API_KEY_MISSING | 403 | Ключ API не был указан. Подробнее об использовании ключа API см. В разделе о передаче API-интерфейса в API. | 120 | | API_KEY_INVALID | 403 | Был указан недопустимый ключ API. Убедитесь, что ключ API прошел успешно, или зарегистрируйтесь для ключа API. | 121 | | API_KEY_DISABLED | 403 | Ключ API был отключен администратором. Пожалуйста свяжитесь с нами для помощи. | 122 | | API_KEY_UNAUTHORIZED | 403 | Предоставленный ключ API не авторизован для доступа к данной службе. Пожалуйста свяжитесь с нами для помощи. | 123 | | API_KEY_UNVERIFIED | 403 | Ключ API не был подтвержден. Проверьте свой адрес электронной почты, чтобы подтвердить ключ API. Пожалуйста свяжитесь с нами для помощи. | 124 | | HTTPS_REQUIRED | 400 | Запросы к этому API должны быть сделаны по протоколу HTTPS. Убедитесь, что используемый URL находится поверх HTTPS. | 125 | | OVER_RATE_LIMIT | 429 | Ключ API превысил лимит запростов. Для получения дополнительной информации свяжитесь с нами. | 126 | | NOT_FOUND | 404 | Не удалось найти API по данному URL-адресу. Проверьте свой URL. | 127 | 128 | 129 | JSON Пример 130 | ```javascript 131 | { 132 | "error": { 133 | "code": "API_KEY_MISSING", 134 | "message": "No api_key was supplied. Get one at https://developers.ria.com" 135 | } 136 | } 137 | ``` 138 | 139 | XML 140 | 141 | ```xml 142 | 143 | 144 | API_KEY_MISSING 145 | No api_key was supplied. Get one at https://developers.ria.com 146 | 147 | 148 | ``` 149 | 150 | CSV 151 | ``` 152 | Error Code,Error Message 153 | API_KEY_MISSING,No api_key was supplied. Get one at https://developers.ria.com 154 | ``` 155 | HTML 156 | 157 | ```html 158 | 159 | 160 |

API_KEY_MISSING

161 |

No api_key was supplied. Get one at https://developers.ria.com

162 | 163 | 164 | ``` 165 | --------------------------------------------------------------------------------