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

Фото и видео

Загружайте фото объектов и добавляйте видео с 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) →

Лучшие практики

Советы для отличных фото объектов

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

Связанные темы