5 Immobiliendokumente
Hängen Sie Verträge, technische Dokumente, Grundrisse und andere Dateien an Ihre Immobilien an — mit rollenbasierter Zugriffskontrolle.
Warum Dokumente anhängen?
Immobiliendokumente halten alle wichtigen Dateien organisiert und zugänglich an einem Ort — Verträge, technische Dokumentation, Grundrisse, Passwörter und mehr.
Vorteile
- Alle Immobiliendateien an einem organisierten Ort
- Rollenbasierte Sichtbarkeit — kontrollieren Sie, wer jedes Dokument sehen kann
- Nach Typ kategorisiert: Verträge, technische Dokumente, Pläne, Passwörter
- Sichere Cloud-Speicherung mit Zugriff über signierte URLs
So fügen Sie Dokumente hinzu
Sie können Dokumente über die Weboberfläche oder über die API hochladen. Jedem Dokument wird ein Typ zugewiesen, und optional kann der Zugriff auf bestimmte Rollen beschränkt werden.
In der Weboberfläche: Öffnen Sie die Immobilienseite und klicken Sie dann im Immobilienmenü auf "Dokumente".
Weitere Informationen finden Sie in der Bibliothek: Immobiliendokumente.
Dokumenttypen
Jedes Dokument gehört zu einer von fünf Kategorien. Wählen Sie den richtigen Typ für die richtige Organisation.
Zugriffskontrolle
Standardmäßig sind Dokumente für alle Immobilienteilnehmer sichtbar. Sie können die Sichtbarkeit auf bestimmte Rollen beschränken. Eigentümer und Agent sehen immer alle Dokumente.
Für Entwickler: REST API
Sie können Immobiliendokumente über die REST-API verwalten. Dateien werden als base64-kodierter Inhalt hochgeladen.
POST Dokument hochladen
▶Laden Sie ein Dokument hoch, indem Sie den Dateiinhalt als base64-kodierten String senden. Geben Sie den Dokumenttyp an, um es zu kategorisieren.
POST /api/v1/properties/{id}/documents
Header:
Authorization: Bearer {token}
Content-Type: application/json
Pflichtfelder:
Optionale Felder:
Anfragekörper:
{
"document_type_id": 1,
"file_content": "base64-encoded-file-content...",
"file_name": "rental-agreement.pdf",
"mime_type": "application/pdf",
"comment": "Rental agreement 2026"
}
Antwort (201 Created):
{
"message": "Document uploaded successfully",
"data": {
"id": 50,
"property_id": "019a1b2c-3d4e-7f5a-8b9c-0123456789ab",
"document_type": {
"id": 1,
"code": "OFFICIAL_DOCUMENT",
"name_key": "document_type.official.name"
},
"file_url": "https://landlordkeeper.com/file/cG1mOjUwOjA6...",
"original_name": "rental-agreement.pdf",
"file_size": 45678,
"file_size_formatted": "44.61 KB",
"mime_type": "application/pdf",
"extension": "pdf",
"is_image": false,
"is_video": false,
"is_pdf": true,
"comment": "Rental agreement 2026",
"visible_to_roles": null,
"created_at": "2026-02-20T12:00:00+00:00"
}
}
GET Dokumente auflisten
▶Alle Dokumente einer Immobilie abrufen. Verwenden Sie den type_id-Filter, um nur bestimmte Typen anzuzeigen.
GET /api/v1/properties/{id}/documents
Abfrageparameter:
Antwort (200 OK):
{
"data": [
{
"id": 50,
"property_id": "019a1b2c-3d4e-7f5a-8b9c-0123456789ab",
"document_type": {"id": 1, "code": "OFFICIAL_DOCUMENT"},
"file_url": "https://landlordkeeper.com/file/cG1mOjUwOjA6...",
"original_name": "rental-agreement.pdf",
"file_size": 45678,
"file_size_formatted": "44.61 KB",
"is_pdf": true,
"comment": "Rental agreement 2026",
"visible_to_roles": null,
"created_at": "2026-02-20T12:00:00+00:00"
}
],
"total": 3,
"stats": {
"total_count": 3,
"total_size": 137034,
"total_size_formatted": "133.82 KB"
}
}
PUT Dokument aktualisieren
▶Aktualisieren Sie den Kommentar und/oder die Sichtbarkeit eines Dokuments. Die Datei selbst kann nicht ersetzt werden — löschen und erneut hochladen.
PUT /api/v1/documents/{documentId}
Anfragekörper:
{
"comment": "Updated rental agreement",
"visible_to": ["PROPERTY_TENANT", "PROPERTY_MAINTENANCE"]
}
Verfügbare Rollen für visible_to:
Antwort (200 OK):
{
"message": "Document updated successfully",
"data": {
"id": 50,
"comment": "Updated rental agreement",
"visible_to_roles": ["PROPERTY_TENANT", "PROPERTY_MAINTENANCE"]
}
}
DELETE Dokument löschen
▶Ein Dokument anhand seiner ID dauerhaft löschen.
DELETE /api/v1/documents/{documentId}
Antwort (200 OK):
{"message": "Document deleted successfully"}
cURL-Beispiele
▶1. Dokument 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": 1,
"file_content": "'$(base64 -w 0 contract.pdf)'",
"file_name": "contract.pdf",
"mime_type": "application/pdf",
"comment": "Rental agreement 2026"
}'
2. Dokumente auflisten
curl https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/documents?type_id=1 \
-H "Authorization: Bearer YOUR_TOKEN_HERE"
3. Dokument aktualisieren
curl -X PUT https://landlordkeeper.com/api/v1/documents/50 \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"visible_to": ["PROPERTY_TENANT"],
"comment": "Visible to tenant"
}'
4. Dokument löschen
curl -X DELETE https://landlordkeeper.com/api/v1/documents/50 \
-H "Authorization: Bearer YOUR_TOKEN_HERE"