Головна › Бібліотека › Фото та відео

Фото та відео

Завантажуйте фото об'єктів та додавайте відео з YouTube для презентації вашої нерухомості

Огляд

Модуль "Медіа об'єкту" дозволяє завантажувати фотографії та додавати відео з YouTube для створення візуальних галерей ваших об'єктів оренди. Фотографії зберігаються безпечно у хмарі, тоді як відео вбудовуються з YouTube.

Завантаження фото

Завантажуйте фото інтер'єру та екстер'єру (JPG, PNG, WEBP, макс. 10 МБ)

Відео з YouTube

Вбудовуйте відео з YouTube за URL для огляду об'єкту та віртуальних турів

Фільтрація та пошук

Фільтруйте медіа за типом (інтер'єр/екстер'єр) та діапазоном дат завантаження

Інтерактивна галерея

Переглядайте фото у лайтбоксі з масштабуванням та елементами навігації

Типи медіа

Система підтримує наступні типи медіа-документів:

Код Назва Опис
PHOTO_INTERIOR Фото інтер'єру Фото інтер'єру (кімнати, житлові приміщення, кухня, ванні)
PHOTO_EXTERIOR Фото екстер'єру Фото екстер'єру (фасад будівлі, двір, паркінг, околиці)
VIDEO_INTERIOR Відео інтер'єру Відео-тури інтер'єру (вбудовані з YouTube)
VIDEO_EXTERIOR Відео екстер'єру Відео-тури екстер'єру (вбудовані з YouTube)
PHOTO_OTHER Інші фото Інші фото, які не класифікуються як інтер'єр або екстер'єр

Робочий процес

Типовий робочий процес управління медіа об'єкту:

1

Відкрити галерею медіа

Перейдіть на сторінку об'єкту та натисніть "Фото / Відео" в меню об'єкту

2

Додати медіа

Натисніть кнопку "Додати", щоб відкрити форму завантаження

3

Вибрати тип

Виберіть тип документа (фото інтер'єру/екстер'єру або відео)

4

Завантажити або додати посилання

Для фото: виберіть файл (JPG/PNG/WEBP, макс. 10 МБ). Для відео: вставте URL з YouTube

Технічні деталі

Вимоги до фотографій

  • Підтримувані формати: JPG, PNG, WEBP
  • Максимальний розмір файлу: 10 МБ
  • Зберігання: безпечне хмарне сховище
  • Доступ: Захищені URL з HMAC підписами

Вимоги до відео

  • Платформа: лише YouTube
  • Підтримувані формати URL:
    • https://www.youtube.com/watch?v=VIDEO_ID
    • https://youtu.be/VIDEO_ID
  • Відео вбудовуються через iframe (без зберігання на вашому сервері)

Права доступу

Права доступу до медіа об'єкту:

Роль Перегляд Додавання Видалення
Наймодавець Так Так Так
Представник наймодавця Так Так Так
Наймач Так Ні Ні
Представник наймача Так Ні Ні
Обслуговуючий персонал Так Ні Ні

REST API

Медіа об'єктів використовує загальний Document API з конкретними типами документів. Всі ендпоінти вимагають JWT автентифікації.

Операції з фотографіями

POST   /api/v1/properties/{id}/documents                - Завантажити фото
GET    /api/v1/properties/{id}/documents?type_id={type} - Список медіа за типом
DELETE /api/v1/properties/{id}/documents/{doc_id}     - Видалити медіа

ID типів документів

Використовуйте наступні коди типів документів при завантаженні:

PHOTO_INTERIOR  - Фото інтер'єру (кімнати, житлові приміщення, кухня, ванні)
PHOTO_EXTERIOR  - Фото екстер'єру (фасад будівлі, двір, паркінг, околиці)
VIDEO_INTERIOR  - Відео-тури інтер'єру (вбудовані з YouTube)
VIDEO_EXTERIOR  - Відео-тури екстер'єру (вбудовані з YouTube)
PHOTO_OTHER     - Інші фото, які не класифікуються як інтер'єр або екстер'єр

Приклад: Завантаження фото інтер'єру

POST /api/v1/properties/123/documents
Content-Type: multipart/form-data
Authorization: Bearer YOUR_JWT_TOKEN

{
    "document_type_code": "PHOTO_INTERIOR",
    "file": [binary file data],
    "comment": "Living room with new furniture"
}

Приклад: Додавання відео з YouTube

POST /api/v1/properties/123/documents
Content-Type: application/json
Authorization: Bearer YOUR_JWT_TOKEN

{
    "document_type_code": "VIDEO_INTERIOR",
    "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "comment": "Full apartment tour 2026"
}

Приклад: Фільтрація за типом

GET /api/v1/properties/123/documents?type_id=5
Authorization: Bearer YOUR_JWT_TOKEN

Response:
{
    "total": 15,
    "items": [
        {
            "id": 45,
            "document_type": {
                "id": 5,
                "code": "PHOTO_INTERIOR",
                "name": "Interior Photo"
            },
            "url": "/file/cG1mOjQ1OjA6ZWEyNTYuLi4",
            "comment": "Living room",
            "uploaded_at": "2026-02-03T14:30:00+00:00"
        }
    ]
}

Інтерактивна документація API

Для повної інтерактивної документації API з прикладами запитів/відповідей відвідайте:

Відкрити Swagger UI →

Найкращі практики

Поради для чудових фото об'єктів

  • Використовуйте гарне освітлення - природне денне світло найкраще
  • Прибирайте та розхламлюйте простори перед фотографуванням
  • Показуйте всі важливі особливості: кухню, ванну, місця зберігання
  • Включіть фото екстер'єру: будівлю, паркінг, двір, околиці
  • Використовуйте широкі кути для показу повного планування кімнат
  • Робіть фото з кутів, щоб максимізувати видимий простір
  • Додавайте відео для віртуальних турів (більш привабливо для орендарів)

Пов'язані теми