Поиск по объектам недвижимости - Витрина ЖК
Метод используется для общего поиска объектов недвижимости в комплексах по заданным параметрам.
Используемый метод: Search.showcase
Поля запроса
Название ключа |
Описание |
Тип значения |
Обязательный |
Значение по-умолчанию |
complex_id |
Идентификатор ЖК (поиск по всем, если не заполнено) |
number |
Нет |
Null |
codes |
Фиас коды региона |
string |
Нет |
" " |
searchbox |
ЖК, улица(строка поиска) |
string |
Нет |
" " |
obj_term_of_delivery |
Срок сдачи объекта |
string |
Нет |
" " |
obj_date_of_delivery_from |
Дата сдачи объекта от |
string |
Нет |
" " |
obj_date_of_delivery_to |
Дата сдачи объекта до |
string |
Нет |
" " |
price_from |
Цена от |
number |
Нет |
Null |
price_to |
Цена до |
number |
Нет |
Null |
floor_from |
Этаж от |
number |
Нет |
Null |
floor_to |
Этаж до |
number |
Нет |
Null |
floors_from |
Этажность от |
number |
Нет |
Null |
floors_to |
Этажность до |
number |
Нет |
Null |
total_area_from |
Общая площадь от |
number |
Нет |
Null |
total_area_to |
Общая площадь до |
number |
Нет |
Null |
living_area_from |
Жилая площадь от |
number |
Нет |
Null |
living_area_to |
Жилая площадь до |
number |
Нет |
Null |
kitchen_area_from |
Площадь кухни от |
number |
Нет |
Null |
kitchen_area_to |
Площадь кухни до |
number |
Нет |
Null |
mkad_from |
Расстояние от мкад |
number |
Нет |
Null |
mkad_to |
Расстояние до мкад |
number |
Нет |
Null |
property_type |
Тип помещения |
number |
Нет |
1 |
type_of_finish_id |
Тип отделки |
number |
Нет |
Null |
build_stage_id |
Стадия готовности |
number |
Нет |
Null |
term_id |
Условия покупки |
number |
Нет |
Null |
is_apartment |
Флаг апартаменты |
boolean |
Нет |
false |
floor_not_first |
Флаг не первый этаж |
boolean |
Нет |
false |
floor_not_last |
Флаг не последний этаж |
boolean |
Нет |
false |
is_duplex |
Флаг двухуровневый |
boolean |
Нет |
false |
rooms |
Количество комнат и признак студии |
array |
Нет |
[ ] |
house_class_id |
Класс объекта |
array |
Нет |
[ ] |
subway_id |
Метро |
array |
Нет |
[ ] |
highway_id |
Шоссе |
array |
Нет |
[ ] |
railway_id |
Шоссе |
array |
Нет |
[ ] |
Пример запроса
1 QUERY_HOST='https://spn24.ru/api/v1'
2 QUERY_ID='530c4636-0408-45f8-ab41-28a749a3c43e'
3 QUERY_METHOD='Search.showcase'
4 QUERY_HEADER='Content-Type: application/json'
5 QUERY_HEADER_AUTH="Authorization: WWWToken XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
6
7 QUERY_BODY="{
8 \"id\": \"$QUERY_ID\",
9 \"jsonrpc\": \"2.0\",
10 \"method\": \"$QUERY_METHOD\",
11 \"params\": {
12 \"build_stage_id\": \"2\",
13 \"change\": true,
14 \"codes\": \"\",
15 \"floor_from\": 2,
16 \"floor_not_first\": true,
17 \"floor_not_last\": true,
18 \"floor_to\": 15,
19 \"floors_from\": 7,
20 \"floors_to\": 17,
21 \"highway_id\": [],
22 \"house_class_id\": [],
23 \"is_apartment\": null,
24 \"is_duplex\": null,
25 \"is_promo\": null,
26 \"kitchen_area_from\": 5.1,
27 \"kitchen_area_to\": 15.6,
28 \"living_area_from\": 20.4,
29 \"living_area_to\": 40.3,
30 \"mkad_from\": null,
31 \"mkad_to\": null,
32 \"obj_term_of_delivery\": \"\",
33 \"obj_date_of_delivery_from\": \"\",
34 \"obj_date_of_delivery_to\": \"\",
35 \"page\": 1,
36 \"price_from\": 3000000,
37 \"price_to\": 9000000,
38 \"property_type\": 1,
39 \"railway_id\": [],
40 \"rooms\": [\"2\"],
41 \"rows\": 12,
42 \"searchbox\": \"\",
43 \"searchbox_caption\": \"\",
44 \"subway_id\": [],
45 \"term_id\": \"1\",
46 \"total_area_from\": 30.2,
47 \"total_area_to\": 70.7,
48 \"type_of_finish_id\": 1,
49 }
50 }"
51
52 curl -i -X POST -H $QUERY_HEADER -H $QUERY_HEADER_AUTH -d $QUERY_BODY $QUERY_HOST
Результат запроса
Результат запроса представляет собой массив из комплексов с основной информацией о нем и о объектах внутри него, удовлетворяющих заданному условию.
Описание основных полей ответа.
Название ключа |
Описание |
Тип значения |
result |
Результат запроса |
object |
count |
Количество комплексов удовлетворяющих заданному условию |
number |
rows |
Массив объектов с детализированной информацией о комплексе |
array |
address |
Адрес комплекса |
string |
caption |
Название комплекса |
string |
complex_id |
id комплекса |
number |
flats |
Общая информация о квартирах, удовлетворяющих заданному условию |
object |
offices |
Общая информация о нежилых помещениях, удовлетворяющих заданному условию |
object |
complex_yandex_id |
id комплекса в справочнике Yandex новостроек |
number |
complex_cian_id |
id комплекса в справочнике Cian новостроек |
number |
complex_avito_id |
id комплекса в справочнике Avito новостроек |
number |
Примет ответа на запрос в формате JSON
{
"id": "4f718a4f-dcec-5aae-7c4d-d05eebeb2bdf",
"jsonrpc": "2.0",
"result": {
"count": 3,
"rows": [
{
"address": "Московская область, Ленинский район, пос. Развилка",
"caption": "ЖК "UP!КВАРТАЛ"Римский"",
"complex_id": 00000,
"deals_status": false,
"flats": {
"caption": "квартир",
"count": 7,
"price_min": 5913394,
"price_promo_min": null,
"sqm_max": 65.9,
"sqm_min": 60.7
},
"flats_count": 7,
"flats_detail_count": [
{
"count": 7,
"rooms": 2
}
],
"flats_min_price": 5913394,
"flats_min_promo": null,
"housing_id": 00000,
"image": "http://dev.spn24.ru/files/upload/c52ac6f9-5800-4ac3-9917-b2730768c12e.png",
"is_mine": true,
"offices": {
"caption": "нежилых помещений",
"count": 0,
"price_min": null,
"price_promo_mini": null,
"sqm_max": null,
"sqm_min": null
},
"special_status": false,
"status": false,
"stock_status": true,
"term_of_delivery": "IV квартал 2018",
"term_of_delivery_line1": "2018",
"term_of_delivery_line2": "IV квартал",
"tip_otd_status": true
},
{
"address": "Московская область, Мытищинский район, деревня Бородино",
"caption": 'ЖК "UP!КВАРТАЛ"Скандинавский"',
"complex_id": 00000,
"deals_status": false,
"flats": {
"caption": "квартир",
"count": 11,
"price_min": 4633680,
"price_promo_min": 5584797.0,
"sqm_max": 65.8,
"sqm_min": 51.6
},
"flats_count": 11,
"flats_detail_count": [
{
"count": 11,
"rooms": 2
}
],
"flats_min_price": 4633680,
"flats_min_promo": 5584797.0,
"housing_id": 00000,
"image": "http://dev.spn24.ru/files/upload/f0f6c4ae-ed4d-4a34-b69b-df32b4c30d47.png",
"is_mine": true,
"offices": {
"caption": "нежилых помещений",
"count": 0,
"price_min": null,
"price_promo_mini": null,
"sqm_max": null,
"sqm_min": null
},
"special_status": false,
"status": false,
"stock_status": true,
"term_of_delivery": "IV квартал 2018",
"term_of_delivery_line1": "2018",
"term_of_delivery_line2": "IV квартал",
"tip_otd_status": false
},
{
"address": "Московская область, г. Домодедово",
"caption": "ЖК «Домодедово Парк»",
"complex_id": 00000,
"deals_status": false,
"flats": {
"caption": "квартир",
"count": 26,
"price_min": 3786000,
"price_promo_min": null,
"sqm_max": 64.0,
"sqm_min": 63.1
},
"flats_count": 26,
"flats_detail_count": [
{
"count": 26,
"rooms": 2
}
],
"flats_min_price": 3786000,
"flats_min_promo": null,
"housing_id": 00000,
"image": "http://dev.spn24.ru/files/upload/d1f07dfd-791b-4e7a-83d4-7d949a8ca628.png",
"is_mine": true,
"offices": {
"caption": 'нежилых помещений',
"count": 0,
"price_min": null,
"price_promo_mini": null,
"sqm_max": null,
"sqm_min": null
},
"special_status": false,
"status": false,
"stock_status": true,
"term_of_delivery": "сдан",
"term_of_delivery_line1": "Сдан",
"term_of_delivery_line2": null,
"tip_otd_status": false
}
]
}
}