4 Immobilienfotos
Laden Sie Innen- und Außenfotos Ihrer Immobilie hoch, um eine visuelle Galerie zu erstellen.
Warum Fotos hinzufügen?
Immobilienfotos sind für die Dokumentation des Zustands Ihrer Mietimmobilie unerlässlich. Sie dienen als visuelle Aufzeichnungen für Vermieter und Mieter.
Vorteile
- Dokumentation des Immobilienzustands vor und nach dem Mieterwechsel
- Visuelle Galerie für potenzielle Mieter
- Sichere Cloud-Speicherung Ihrer Fotos
- Separate Kategorien für Innen- und Außenfotos
So fügen Sie Fotos hinzu
Sie können Fotos über die Weboberfläche oder über die API hochladen. Die Weboberfläche unterstützt Drag-and-Drop-Datei-Upload.
In der Weboberfläche: Öffnen Sie die Immobilienseite und klicken Sie dann im Immobilienmenü auf "Foto / Video", um die Mediengalerie zu öffnen.
Weitere Informationen finden Sie in der Bibliothek: Immobilienfotos & Videos.
Medientypen
Jedes Foto oder Video gehört zu einem von fünf Medientypen. Verwenden Sie den entsprechenden Typ für die richtige Organisation.
Upload-Anforderungen
Für Entwickler: REST API
Sie können Immobilienmedien über die REST-API verwalten. Fotos werden als base64-kodierter Inhalt hochgeladen.
POST Foto hochladen
▶Laden Sie ein Foto hoch, indem Sie den Dateiinhalt als base64-kodierten String senden. Geben Sie den Dokumenttyp an, um das Foto zu kategorisieren.
POST /api/v1/properties/{id}/documents
Header:
Authorization: Bearer {token}
Content-Type: application/json
Pflichtfelder:
Optionale Felder:
Anfragekörper:
{
"document_type_id": 6,
"file_content": "base64-encoded-file-content...",
"file_name": "living-room.webp",
"mime_type": "image/webp",
"comment": "Living room photo"
}
Antwort (201 Created):
{
"message": "Document uploaded successfully",
"data": {
"id": 45,
"property_id": "019a1b2c-3d4e-7f5a-8b9c-0123456789ab",
"document_type": {
"id": 6,
"code": "PHOTO_INTERIOR",
"name_key": "document_type.photo_interior"
},
"file_url": "https://landlordkeeper.com/file/cG1mOjQ1OjA6...",
"original_name": "living-room.webp",
"file_size": 125000,
"file_size_formatted": "122.07 KB",
"mime_type": "image/webp",
"extension": "webp",
"is_image": true,
"is_video": false,
"is_pdf": false,
"comment": "Living room photo",
"created_at": "2026-02-20T12:00:00+00:00"
}
}
GET Immobilienmedien auflisten
▶Alle Dokumente einer Immobilie abrufen. Verwenden Sie den type_id-Filter, um nur bestimmte Medientypen anzuzeigen.
GET /api/v1/properties/{id}/documents
Abfrageparameter:
Antwort (200 OK):
{
"data": [
{
"id": 45,
"property_id": "019a1b2c-3d4e-7f5a-8b9c-0123456789ab",
"document_type": {"id": 6, "code": "PHOTO_INTERIOR"},
"file_url": "https://landlordkeeper.com/file/cG1mOjQ1OjA6...",
"original_name": "living-room.webp",
"file_size": 125000,
"is_image": true,
"comment": "Living room photo",
"created_at": "2026-02-20T12:00:00+00:00"
}
],
"total": 3,
"stats": {
"total_count": 3,
"total_size": 375000,
"total_size_formatted": "366.21 KB"
}
}
GET Dokumenttypen abrufen
▶Die Liste aller verfügbaren Dokumenttypen mit ihren IDs, erlaubten Erweiterungen und Größenbeschränkungen abrufen.
GET /api/v1/document-types
Antwort (200 OK):
{
"data": [
{"id": 6, "code": "PHOTO_INTERIOR", "allowed_extensions": "jpg,jpeg,png,webp", "max_size_mb": 10},
{"id": 7, "code": "PHOTO_EXTERIOR", "allowed_extensions": "jpg,jpeg,png,webp", "max_size_mb": 10},
{"id": 8, "code": "VIDEO_INTERIOR", "allowed_extensions": "mp4,webm", "max_size_mb": 50},
{"id": 9, "code": "VIDEO_EXTERIOR", "allowed_extensions": "mp4,webm", "max_size_mb": 50},
{"id": 10, "code": "PHOTO_OTHER", "allowed_extensions": "jpg,jpeg,png,webp", "max_size_mb": 10}
]
}
cURL-Beispiele:
curl https://landlordkeeper.com/api/v1/document-types
DELETE Foto löschen
▶Ein Dokument anhand seiner ID löschen. Die Datei und der Datenbankeintrag werden dauerhaft gelöscht.
DELETE /api/v1/documents/{documentId}
Antwort (200 OK):
{"message": "Document deleted successfully"}
cURL-Beispiele
▶1. Foto hochladen
curl -X POST https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/documents \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"document_type_id": 6,
"file_content": "'$(base64 -w 0 photo.webp)'",
"file_name": "living-room.webp",
"mime_type": "image/webp",
"comment": "Living room"
}'
2. Immobilienmedien auflisten
curl https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/documents?type_id=6 \
-H "Authorization: Bearer YOUR_TOKEN_HERE"
3. Foto löschen
curl -X DELETE https://landlordkeeper.com/api/v1/documents/45 \
-H "Authorization: Bearer YOUR_TOKEN_HERE"