Startseite › Bibliothek › Fotos und Videos

Fotos und Videos

Laden Sie Immobilienfotos hoch und fügen Sie YouTube-Videos hinzu, um Ihre Mietobjekte zu präsentieren

Überblick

Das Immobilien-Medien-Modul ermöglicht das Hochladen von Fotos und das Hinzufügen von YouTube-Videos zur Erstellung visueller Galerien für Ihre Mietobjekte. Fotos werden sicher in der Cloud gespeichert, während Videos von YouTube eingebettet werden.

Foto-Upload

Laden Sie Innen- und Außenfotos hoch (JPG, PNG, WEBP, max. 10 MB)

YouTube-Videos

Betten Sie YouTube-Videos per URL für Immobilienführungen und Rundgänge ein

Filterung und Suche

Filtern Sie Medien nach Typ (Innen/Außen) und Upload-Datumsbereich

Interaktive Galerie

Betrachten Sie Fotos in der Lightbox mit Zoom und Navigationssteuerelementen

Medientypen

Das System unterstützt die folgenden Mediendokumenttypen:

Code Name Beschreibung
PHOTO_INTERIOR Innenaufnahme Innenfotos (Zimmer, Wohnräume, Küche, Badezimmer)
PHOTO_EXTERIOR Außenaufnahme Außenfotos (Gebäudefassade, Hof, Parkplatz, Umgebung)
VIDEO_INTERIOR Innenvideo Innen-Videotouren (YouTube-Einbettung)
VIDEO_EXTERIOR Außenvideo Außen-Videotouren (YouTube-Einbettung)
PHOTO_OTHER Sonstige Fotos Sonstige Fotos, die nicht als Innen- oder Außenaufnahmen kategorisiert sind

Arbeitsablauf

Typischer Arbeitsablauf für die Verwaltung von Immobilienmedien:

1

Mediengalerie öffnen

Navigieren Sie zur Immobilienseite und klicken Sie auf "Fotos / Videos" im Immobilienmenü

2

Medien hinzufügen

Klicken Sie auf die Schaltfläche "Hinzufügen", um das Upload-Formular zu öffnen

3

Typ wählen

Wählen Sie den Dokumenttyp (Innen-/Außenfoto oder Video)

4

Hochladen oder verlinken

Für Fotos: Datei auswählen (JPG/PNG/WEBP, max. 10 MB). Für Videos: YouTube-URL einfügen

Technische Details

Foto-Anforderungen

  • Unterstützte Formate: JPG, PNG, WEBP
  • Maximale Dateigröße: 10 MB
  • Speicherung: sicherer Cloud-Speicher
  • Zugriff: Sichere URLs mit HMAC-Signaturen

Video-Anforderungen

  • Plattform: nur YouTube
  • Unterstützte URL-Formate:
    • https://www.youtube.com/watch?v=VIDEO_ID
    • https://youtu.be/VIDEO_ID
  • Videos werden per iframe eingebettet (keine Speicherung auf Ihrem Server)

Berechtigungen

Zugriffsrechte für Immobilienmedien:

Rolle Ansehen Hinzufügen Löschen
Vermieter Ja Ja Ja
Vermietervertreter Ja Ja Ja
Mieter Ja Nein Nein
Mietervertreter Ja Nein Nein
Wartungspersonal Ja Nein Nein

REST API

Immobilienmedien verwenden die allgemeine Dokument-API mit spezifischen Dokumenttypen. Alle Endpunkte erfordern JWT-Authentifizierung.

Foto-Operationen

POST   /api/v1/properties/{id}/documents                - Foto hochladen
GET    /api/v1/properties/{id}/documents?type_id={type} - Medien nach Typ auflisten
DELETE /api/v1/properties/{id}/documents/{doc_id}     - Medien löschen

Dokumenttyp-IDs

Verwenden Sie beim Hochladen die folgenden Dokumenttyp-Codes:

PHOTO_INTERIOR  - Innenfotos (Zimmer, Wohnräume, Küche, Badezimmer)
PHOTO_EXTERIOR  - Außenfotos (Gebäudefassade, Hof, Parkplatz, Umgebung)
VIDEO_INTERIOR  - Innen-Videotouren (YouTube-Einbettung)
VIDEO_EXTERIOR  - Außen-Videotouren (YouTube-Einbettung)
PHOTO_OTHER     - Sonstige Fotos, die nicht als Innen- oder Außenaufnahmen kategorisiert sind

Beispiel: Innenfoto hochladen

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

Beispiel: YouTube-Video hinzufügen

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

Beispiel: Nach Typ filtern

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

Interaktive API-Dokumentation

Für die vollständige interaktive API-Dokumentation mit Anfrage-/Antwortbeispielen besuchen Sie:

Swagger UI öffnen →

Best Practices

Tipps für großartige Immobilienfotos

  • Verwenden Sie gute Beleuchtung - natürliches Tageslicht ist am besten
  • Räumen Sie auf und entrümpeln Sie die Räume vor dem Fotografieren
  • Zeigen Sie alle wichtigen Merkmale: Küche, Badezimmer, Stauraum
  • Fügen Sie Außenaufnahmen hinzu: Gebäude, Parkplatz, Hof, Nachbarschaft
  • Verwenden Sie Weitwinkel, um das vollständige Raumlayout zu zeigen
  • Machen Sie Fotos aus Ecken, um den sichtbaren Raum zu maximieren
  • Fügen Sie Videos für virtuelle Rundgänge hinzu (ansprechender für Mieter)

Verwandte Themen