Главная › Настройка объекта › Описание объекта недвижимости

2 Описание объекта недвижимости

Заполните детали: описание, площадь, характеристики и другую важную информацию об объекте

Почему это важно?

Детально описанный объект помогает отслеживать все важные детали, упрощает подготовку договоров и объявлений, и даёт полную картину вашего портфеля недвижимости.

Детальное описание позволяет:

Быстро находить нужный объект по характеристикам
Готовить объявления об аренде со всеми необходимыми деталями
Сравнивать объекты в вашем портфеле
Хранить всю техническую информацию об объекте в одном месте

Как редактировать объект

Откройте любой объект из списка и нажмите кнопку «Редактировать». Вы увидите форму со всеми доступными полями для заполнения.

Перейдите в «Объекты» → выберите объект → нажмите «Редактировать» в правом верхнем углу.

Подробнее читайте в разделе Объекты недвижимости в Библиотеке.

Основная информация

Начните с заполнения основных данных. Эти поля отображаются на карточке объекта и в списке.

Описание Текстовое описание: расположение, особенности, состояние

Жилая площадь Полезная жилая площадь в м²

Общая площадь Общая площадь со всеми помещениями в м²

Улица Название улицы для более точного адреса

Квартира Номер квартиры или помещения

Цвет Цветовая метка для быстрой визуальной идентификации в списке

Дополнительные характеристики

Ниже основных полей вы найдёте раздел дополнительных характеристик. Он содержит детальную техническую информацию, организованную по группам. Заполняйте только то, что относится к вашему типу объекта.

Здание

Общая информация о здании: год постройки, тип, материалы, этажность, энергокласс.

Этажи Год постройки Тип здания Материал стен Энергокласс Высота потолка

Квартира / Помещение

Детали о помещении: комнаты, санузлы, этаж, балконы, состояние, планировка, вид из окон.

Комнаты Спальни Санузлы Этаж Балконы Состояние Планировка

Коммуникации

Отопление, горячая вода, газ, интернет, кондиционирование, вентиляция и другие коммунальные системы.

Отопление Горячая вода Газ Интернет Кондиционер

Инфраструктура

Инфраструктура рядом: лифты, расстояние до метро, школы, детсада, магазинов, парков.

Лифты Расстояние до метро Школа Магазины Парки

Парковка

Возможности парковки: тип парковки, количество мест, площадь гаража.

Парковочные места Тип парковки Площадь гаража

Земельный участок

Для домов и участков: площадь, назначение, категория, тип грунта, ограждение, расстояние до воды и леса.

Площадь участка Назначение Тип грунта Ограждение

Другое

Дополнительная информация: мебель, тип плиты, максимальное количество жильцов.

Мебель Тип плиты Макс. жильцов

Не обязательно заполнять все характеристики сразу. Вы всегда можете вернуться и добавить больше деталей позже.

Для разработчиков: REST API

Вы также можете обновлять детали и характеристики объекта через REST API.

PUT Обновление объекта

▶

Обновите основные поля объекта: описание, площадь, детали адреса. Отправляйте только те поля, которые хотите изменить.

PUT /api/v1/properties/{id}

Заголовки:

                    Authorization: Bearer {token}
Content-Type: application/json
                

Тело запроса:

{
  "description": "Cozy 2-room apartment in the city center, 5th floor",
  "living_area": 45.5,
  "total_area": 68.0,
  "apartment_number": "42"
}

Ответ (200 OK):

{
  "message": "Property updated successfully",
  "data": {
    "id": "019a1b2c-3d4e-7f5a-8b9c-0123456789ab",
    "name": "My Apartment",
    "description": "Cozy 2-room apartment in the city center, 5th floor",
    "living_area": "45.50",
    "total_area": "68.00"
  }
}

GET Доступные коды характеристик

▶

Перед установкой характеристик получите список доступных кодов и их типов данных. Каждый код принадлежит группе (building, apartment, utilities и т.д.).

GET /api/v1/property-data-types/grouped

Ответ (200 OK):

{
  "data": {
    "building": [
      {"code": "FLOOR_COUNT", "data_type": "int", "unit": null},
      {"code": "YEAR_BUILT", "data_type": "int", "unit": null},
      {"code": "BUILDING_TYPE", "data_type": "string", "unit": null}
    ],
    "apartment": [
      {"code": "ROOM_COUNT", "data_type": "int", "unit": null},
      {"code": "FLOOR_NUMBER", "data_type": "int", "unit": null}
    ],
    "utilities": [...],
    "infrastructure": [...],
    "parking": [...],
    "land": [...]
  },
  "groups": ["building", "apartment", "utilities", ...]
}

Чтобы увидеть допустимые значения для конкретного кода (например, полей-перечислений вроде BUILDING_TYPE), запросите его детали:

GET /api/v1/property-data-types/BUILDING_TYPE

Ответ (200 OK):

{
  "code": "BUILDING_TYPE",
  "data_type": "string",
  "group_code": "building",
  "constraints": {
    "allowedValues": ["panel", "brick", "monolith", "wood",
      "block", "foam_block", "frame", "mixed", "other"]
  }
}

Для типов int/float API возвращает input_hint с допустимым диапазоном (например, "1 - 200"). Для типов string с перечислением значений возвращается массив allowed_values.

PUT Обновление характеристик

▶

Используйте batch-эндпоинт для установки нескольких характеристик одновременно. Значения передаются как пары код-значение.

PUT /api/v1/properties/{id}/data-values/batch

Тело запроса:

{
  "values": {
    "ROOM_COUNT": "3",
    "FLOOR_NUMBER": "5",
    "FLOOR_COUNT": "9",
    "YEAR_BUILT": "2015",
    "BUILDING_TYPE": "brick",
    "HEATING_TYPE": "central",
    "APARTMENT_CONDITION": "euro_repair",
    "BATHROOM_COUNT": "1",
    "BALCONY_COUNT": "1",
    "ELEVATOR_COUNT": "2"
  }
}

Ответ (200 OK):

{
  "message": "Values updated successfully",
  "updated": 10,
  "removed": 0,
  "errors": []
}

Примеры cURL

▶

1. Обновление объекта

curl -X PUT https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -d '{
    "description": "Cozy 2-room apartment in the city center",
    "living_area": 45.5,
    "total_area": 68.0,
    "apartment_number": "42"
  }'

2. Обновление характеристик

curl -X PUT https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/data-values/batch \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -d '{
    "values": {
      "ROOM_COUNT": "3",
      "FLOOR_NUMBER": "5",
      "FLOOR_COUNT": "9",
      "BUILDING_TYPE": "brick",
      "HEATING_TYPE": "central"
    }
  }'

Замените YOUR_TOKEN_HERE на JWT-токен из шага аутентификации.

← Создание объекта недвижимости Инвентаризация имущества →