4 Zdjęcia nieruchomości
Prześlij zdjęcia wnętrz i zewnętrza nieruchomości, aby stworzyć galerię wizualną.
Dlaczego warto dodać zdjęcia?
Zdjęcia nieruchomości są niezbędne do dokumentowania stanu wynajmowanej nieruchomości. Służą jako wizualne zapisy zarówno dla właścicieli, jak i najemców.
Korzyści
- Dokumentowanie stanu nieruchomości przed i po przeprowadzce najemcy
- Galeria wizualna dla potencjalnych najemców
- Bezpieczne przechowywanie zdjęć w chmurze
- Osobne kategorie dla zdjęć wnętrz i zewnętrza
Jak dodać zdjęcia
Możesz przesyłać zdjęcia przez interfejs webowy lub przez API. Interfejs webowy obsługuje przesyłanie plików metodą przeciągnij i upuść.
W interfejsie webowym: otwórz stronę nieruchomości, następnie kliknij "Zdjęcia / Wideo" w menu nieruchomości, aby otworzyć galerię multimediów.
Zobacz pełną dokumentację w Bibliotece: Zdjęcia i filmy nieruchomości.
Typy multimediów
Każde zdjęcie lub wideo należy do jednego z pięciu typów multimediów. Użyj odpowiedniego typu dla właściwej organizacji.
Wymagania dotyczące przesyłania
Dla programistów: REST API
Możesz zarządzać multimediami nieruchomości przez REST API. Zdjęcia są przesyłane jako zawartość zakodowana w base64.
POST Prześlij zdjęcie
▶Prześlij zdjęcie, wysyłając zawartość pliku jako zakodowany ciąg base64. Określ typ dokumentu, aby skategoryzować zdjęcie.
POST /api/v1/properties/{id}/documents
Nagłówki:
Authorization: Bearer {token}
Content-Type: application/json
Wymagane pola:
Pola opcjonalne:
Treść żądania:
{
"document_type_id": 6,
"file_content": "base64-encoded-file-content...",
"file_name": "living-room.webp",
"mime_type": "image/webp",
"comment": "Living room photo"
}
Odpowiedź (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 Lista multimediów nieruchomości
▶Pobierz wszystkie dokumenty nieruchomości. Użyj filtra type_id, aby wyświetlić tylko określone typy multimediów.
GET /api/v1/properties/{id}/documents
Parametry zapytania:
Odpowiedź (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 Pobierz typy dokumentów
▶Pobierz listę wszystkich dostępnych typów dokumentów z ich ID, dozwolonymi rozszerzeniami i limitami rozmiaru.
GET /api/v1/document-types
Odpowiedź (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}
]
}
Przykłady cURL:
curl https://landlordkeeper.com/api/v1/document-types
DELETE Usuń zdjęcie
▶Usuń dokument po jego ID. Plik i rekord w bazie danych są trwale usuwane.
DELETE /api/v1/documents/{documentId}
Odpowiedź (200 OK):
{"message": "Document deleted successfully"}
Przykłady cURL
▶1. Prześlij zdjęcie
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. Lista multimediów nieruchomości
curl https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/documents?type_id=6 \
-H "Authorization: Bearer YOUR_TOKEN_HERE"
3. Usuń zdjęcie
curl -X DELETE https://landlordkeeper.com/api/v1/documents/45 \
-H "Authorization: Bearer YOUR_TOKEN_HERE"