Strona główna › Biblioteka › Zdjęcia i filmy

Zdjęcia i filmy

Przesyłaj zdjęcia nieruchomości i dodawaj filmy z YouTube, aby zaprezentować swoje wynajmy

Przegląd

Moduł Mediów Nieruchomości umożliwia przesyłanie zdjęć i dodawanie filmów z YouTube w celu utworzenia wizualnych galerii Twoich wynajmów. Zdjęcia są bezpiecznie przechowywane w chmurze, podczas gdy filmy są osadzone z YouTube.

Przesyłanie zdjęć

Przesyłaj zdjęcia wnętrz i zewnętrzne (JPG, PNG, WEBP, max 10 MB)

Filmy YouTube

Osadzaj filmy z YouTube za pomocą adresu URL do wycieczek po nieruchomościach

Filtrowanie i wyszukiwanie

Filtruj media według typu (wnętrze/zewnętrze) i zakresu dat przesyłania

Interaktywna galeria

Przeglądaj zdjęcia w lightboxie z powiększeniem i kontrolkami nawigacji

Typy mediów

System obsługuje następujące typy dokumentów multimedialnych:

Kod Nazwa Opis
PHOTO_INTERIOR Zdjęcie wnętrza Zdjęcia wnętrz (pokoje, przestrzenie mieszkalne, kuchnia, łazienki)
PHOTO_EXTERIOR Zdjęcie zewnętrzne Zdjęcia zewnętrzne (fasada budynku, podwórko, parking, okolica)
VIDEO_INTERIOR Wideo wnętrza Wideo-wycieczki po wnętrzach (osadzone z YouTube)
VIDEO_EXTERIOR Wideo zewnętrzne Wideo-wycieczki zewnętrzne (osadzone z YouTube)
PHOTO_OTHER Inne zdjęcia Inne zdjęcia niesklasyfikowane jako wnętrze lub zewnętrze

Przepływ pracy

Typowy przepływ pracy do zarządzania mediami nieruchomości:

1

Otwórz galerię mediów

Przejdź do strony nieruchomości i kliknij "Zdjęcia / Filmy" w menu nieruchomości

2

Dodaj media

Kliknij przycisk "Dodaj", aby otworzyć formularz przesyłania

3

Wybierz typ

Wybierz typ dokumentu (zdjęcie wnętrza/zewnętrzne lub wideo)

4

Prześlij lub dodaj link

Dla zdjęć: wybierz plik (JPG/PNG/WEBP, max 10 MB). Dla filmów: wklej URL YouTube

Szczegóły techniczne

Wymagania dotyczące zdjęć

  • Obsługiwane formaty: JPG, PNG, WEBP
  • Maksymalny rozmiar pliku: 10 MB
  • Przechowywanie: bezpieczna pamięć w chmurze
  • Dostęp: Bezpieczne adresy URL z podpisami HMAC

Wymagania dotyczące filmów

  • Platforma: tylko YouTube
  • Obsługiwane formaty URL:
    • https://www.youtube.com/watch?v=VIDEO_ID
    • https://youtu.be/VIDEO_ID
  • Filmy są osadzane za pomocą iframe (brak przechowywania na Twoim serwerze)

Uprawnienia

Prawa dostępu do mediów nieruchomości:

Rola Wyświetlanie Dodawanie Usuwanie
Gospodarz Tak Tak Tak
Agent wynajmujący Tak Tak Tak
Najemca Tak Nie Nie
Agent najemcy Tak Nie Nie
Personel konserwacyjny Tak Nie Nie

REST API

Media nieruchomości używają ogólnego interfejsu API dokumentów z określonymi typami dokumentów. Wszystkie punkty końcowe wymagają uwierzytelnienia JWT.

Operacje na zdjęciach

POST   /api/v1/properties/{id}/documents                - Prześlij zdjęcie
GET    /api/v1/properties/{id}/documents?type_id={type} - Lista mediów według typu
DELETE /api/v1/properties/{id}/documents/{doc_id}     - Usuń media

Identyfikatory typów dokumentów

Użyj następujących kodów typów dokumentów podczas przesyłania:

PHOTO_INTERIOR  - Zdjęcia wnętrz (pokoje, przestrzenie mieszkalne, kuchnia, łazienki)
PHOTO_EXTERIOR  - Zdjęcia zewnętrzne (fasada budynku, podwórko, parking, okolica)
VIDEO_INTERIOR  - Wideo-wycieczki po wnętrzach (osadzone z YouTube)
VIDEO_EXTERIOR  - Wideo-wycieczki zewnętrzne (osadzone z YouTube)
PHOTO_OTHER     - Inne zdjęcia niesklasyfikowane jako wnętrze lub zewnętrze

Przykład: Prześlij zdjęcie wnętrza

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"
}

Przykład: Dodaj film z 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"
}

Przykład: Filtrowanie według typu

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"
        }
    ]
}

Interaktywna dokumentacja API

Aby uzyskać pełną interaktywną dokumentację API z przykładami żądań/odpowiedzi, odwiedź:

Otwórz Swagger UI →

Najlepsze praktyki

Wskazówki dotyczące wspaniałych zdjęć nieruchomości

  • Używaj dobrego oświetlenia - naturalne światło dzienne jest najlepsze
  • Oczyść i uporządkuj przestrzenie przed fotografowaniem
  • Pokaż wszystkie ważne cechy: kuchnię, łazienkę, schowki
  • Dołącz zdjęcia zewnętrzne: budynek, parking, podwórko, okolica
  • Używaj szerokich kątów, aby pokazać pełny układ pomieszczenia
  • Rób zdjęcia z rogów, aby zmaksymalizować widoczną przestrzeń
  • Dodaj filmy do wirtualnych wycieczek (bardziej angażujące dla najemców)

Powiązane tematy