Головна › Налаштування об'єкта › Опис об'єкта нерухомості

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-токен з кроку автентифікації.

← Створення об'єкта нерухомості Інвентаризація майна →