= Получение списка корпусов в ЖК =
Метод '''Housing_complex.get_housings''' является промежуточным между методами '''Search.showcase''' и '''Chessboard.full'''. Используется для получения списка корпусов внутри конкретного ЖК с их идентификаторами для дальнейшего использования метода '''Chessboard.full''' (с входящим параметром housing_id - идентификатором корпуса, содержится в выводе данного метода). Используемый метод: '''Housing_complex.get_housings'''

== Пример запроса ==

||'''Название ключа'''||'''Описание'''   ||'''Тип значения'''||'''Обязательный'''||'''Значение по-умолчанию'''||
||realty_id           ||Идентификатор ЖК ||number            ||Да                ||-                          ||
||form_data           ||Данные фильтров  ||object            ||Нет               ||{    "area_id":[],    "bank_id":[],    "subway_id":[],    "highway_id":[],    "railway_id":[],    "_southWest":[],    "_northEast":[],    "rooms":[],    "house_class_id":[]} ||

{{{#!highlight bash
QUERY_HOST="https://someserver/path/to/api"
QUERY_ID="530c4636-0408-45f8-ab41-28a749a3c43e"
QUERY_METHOD="Housing_complex.get_housings"

COMPLEX_ID="xxx"

QUERY_HEADER="Content-Type: application/json"
QUERY_HEADER_AUTH="Authorization: WWWToken XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

QUERY_BODY="{
    \"id\": \"$QUERY_ID\",
    \"method\": \"$QUERY_METHOD\",
    \"jsonrpc\": \"2.0\",
    \"params\": {
       \"realty_id\": \"$COMPLEX_ID\",
    }
}"

curl -i -X POST -H $QUERY_HEADER -H $QUERY_HEADER_AUTH -d $QUERY_BODY $QUERY_HOST
}}}

== Результат запроса ==

Результат запроса представляет собой массив из корпусов ЖК

||'''Название ключа'''||'''Описание'''                                                                                                            ||'''Тип значения'''||
||housing_id          ||Идентификатор корпуса                                                                                                     ||number            ||
||housing_caption     ||Название корпуса                                                                                                          ||string            ||
||address             ||Адрес                                                                                                                     ||string            ||
||deals_status        ||Присутствие в условиях продажи ипотеки, военной ипотеки, материнского капитала                                            ||boolean           ||
||flats               ||Сводные параметры квартир в продаже внутри корпуса (количество, минимальная стоимость, минимальная и максимальная площади)||object            ||
||housing_create_date ||Дата создания корпуса                                                                                                     ||string            ||
||housing_create_time ||Время создания корпуса                                                                                                    ||string            ||
||housing_image       ||Ссылка на изображение корпуса                                                                                             ||string            ||
||stocks_info         ||Информация по действующим акциям                                                                                          ||array             ||
||term_of_delivery    ||Срок сдачи                                                                                                                ||string            ||
||tip_otd_status      ||Наличие отделки в помещениях корпуса                                                                                      ||boolean           ||

Частный пример ответа на запрос в формате JSON

{{{#!highlight bash
{
  "id": "bfbac7ef-07d2-30fb-5c2a-32a8cff08cec",
  "jsonrpc": "2.0",
  "result": [
    {
      "address": "г Москва, ул Хуторская 2-я, д 34",
      "deals_status": false,
      "flats": {
        "caption": "квартир",
        "count": 96,
        "price_min": 12826088,
        "price_promo_min": null,
        "sqm_max": 90.79,
        "sqm_min": 38.87
      },
      "flats_min_price": 12826088,
      "housing_caption": "Корпус B - Crystal",
      "housing_create_date": "19.02.2021",
      "housing_create_time": "13:16",
      "housing_flats": 96,
      "housing_id": 333574,
      "housing_image": "http://localhost:8000/files/upload/e9d90f9a-1667-4cf4-aac5-fc4f9cbe1649.jpg",
      "special_status": false,
      "stocks_info": [
        {
          "badge_caption": "НОВЫЙ ПРОЕКТ",
          "color": "#44dbef",
          "date_end": "09.05.2022",
          "stock_website": ""
        },
        {
          "badge_caption": "СТАРТ ПРОДАЖ",
          "color": "#ffcd36",
          "date_end": "09.05.2022",
          "stock_website": ""
        }
      ],
      "term_of_delivery": "IV квартал 2023",
      "term_of_delivery_line1": "2023",
      "term_of_delivery_line2": "IV квартал",
      "tip_otd_status": true
    },
    {
      "address": "г Москва, ул Хуторская 2-я, д 34",
      "deals_status": false,
      "flats": {
        "caption": "квартир",
        "count": 105,
        "price_min": 12772229,
        "price_promo_min": null,
        "sqm_max": 92.59,
        "sqm_min": 37.35
      },
      "flats_min_price": 12772229,
      "housing_caption": "Корпус C - Silver",
      "housing_create_date": "19.02.2021",
      "housing_create_time": "13:16",
      "housing_flats": 105,
      "housing_id": xxxx,
      "housing_image": "http://localhost:8000/files/upload/e9d90f9a-1667-4cf4-aac5-fc4f9cbe1649.jpg",
      "special_status": false,
      "stocks_info": [
        {
          "badge_caption": "НОВЫЙ ПРОЕКТ",
          "color": "#44dbef",
          "date_end": "09.05.2022",
          "stock_website": ""
        },
        {
          "badge_caption": "СТАРТ ПРОДАЖ",
          "color": "#ffcd36",
          "date_end": "09.05.2022",
          "stock_website": ""
        }
      ],
      "term_of_delivery": "IV квартал 2023",
      "term_of_delivery_line1": "2023",
      "term_of_delivery_line2": "IV квартал",
      "tip_otd_status": true
    }
  ]
}

}}}