Поиск по объектам недвижимости - Витрина ЖК
Метод используется для общего поиска объектов недвижимости в комплексах по заданным параметрам.
Используемый метод: 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
      }
    ]
  }
}