6 Komunikacja i dostępy
Przechowuj wszystkie dane połączeń nieruchomości: internet, TV, alarm, monitoring, inteligentny dom — z danymi logowania, dokumentami i datami ważności.
Dlaczego warto przechowywać komunikację?
Każda nieruchomość ma wiele usług i połączeń: internet, telefon, alarm, monitoring, dostęp do bramy, systemy inteligentnego domu. Przechowywanie wszystkich tych informacji w jednym miejscu oszczędza czas i zapobiega pomyłkom — zwłaszcza gdy zarządzasz kilkoma nieruchomościami lub musisz udostępnić dostęp najemcom.
Co możesz zorganizować
- Dane WiFi i dostawcy internetu
- Dostęp do alarmu i monitoringu
- Ustawienia inteligentnego domu i pilota bramy
- Szczegóły usług TV i telefonii
- Dołączone umowy i instrukcje dla każdej usługi
Jakie informacje przechowywać
Każdy rekord komunikacji może przechowywać następujące informacje:
Hasła są przechowywane w formie zaszyfrowanej i domyślnie ukryte w interfejsie. Choć możesz używać pola hasła do kodów WiFi, PIN-ów alarmu i podobnych danych dostępu, zalecamy używanie pola hasła tylko do niekrytycznych kodów. Dla szczególnie ważnych danych logowania rozważ użycie dedykowanego menedżera haseł. Serwis przechowuje dane bezpiecznie, ale każdy użytkownik sam decyduje, jakie informacje zapisywać.
Jak dodać komunikację
Możesz dodawać i zarządzać komunikacją przez interfejs webowy lub przez API.
W interfejsie webowym: otwórz stronę nieruchomości, następnie kliknij "Komunikacja" w menu nieruchomości.
Zobacz pełną dokumentację w Bibliotece: Komunikacja.
Typy komunikacji
14 wbudowanych typów obejmuje wszystkie typowe usługi nieruchomości. Użyj GET /api/communication-types, aby uzyskać pełną listę z ID.
Dołączone dokumenty
Do każdej komunikacji można dołączyć dokumenty — umowy, instrukcje, faktury. Najpierw prześlij dokument do nieruchomości (POST /api/properties/{id}/documents), a następnie dołącz go do komunikacji po ID dokumentu.
Przykładowe dokumenty
- Umowa z dostawcą internetu
- Instrukcja montażu alarmu
- Instrukcja konfiguracji aplikacji inteligentnego domu
- Instrukcja programowania pilota bramy
Dla programistów: REST API
Zarządzaj komunikacją nieruchomości przez REST API. Pole information obsługuje HTML do formatowania.
GET Pobierz typy komunikacji
▶Pobierz listę wszystkich dostępnych typów komunikacji z ich ID.
GET /api/v1/communication-types
Odpowiedź (200 OK):
{
"data": [
{"id": 1, "code": "WIFI", "name_key": "communication_type.wifi.name"},
{"id": 5, "code": "INTERNET_FIBER", "name_key": "communication_type.internet_fiber.name"},
{"id": 10, "code": "VIDEO_SURVEILLANCE", "name_key": "communication_type.video_surveillance.name"},
{"id": 11, "code": "ALARM_SYSTEM", "name_key": "communication_type.alarm_system.name"}
]
}
POST Utwórz komunikację
▶Utwórz nowy rekord komunikacji dla nieruchomości. Tylko communication_type_id jest wymagany, pozostałe pola są opcjonalne.
POST /api/v1/properties/{id}/communications
Nagłówki:
Authorization: Bearer {token}
Content-Type: application/json
Treść żądania:
{
"communication_type_id": 1,
"login": "MyNetwork",
"password": "wifi-pass-2026",
"access_address": "192.168.1.1",
"information": "<p>Router: TP-Link Archer AX73</p><p>Provider: Kyivstar Fiber 500 Mbps</p>",
"is_active": true
}
Pole `information` obsługuje formatowanie HTML (tabele, listy, nagłówki, akapity, linki, style inline). Ze względów bezpieczeństwa cały HTML jest oczyszczany na serwerze — skrypty, iframe, procedury obsługi zdarzeń i niebezpieczne atrybuty są automatycznie usuwane.
Odpowiedź (201 Created):
{
"message": "Communication created successfully",
"data": {
"id": 1,
"property_id": "019a1b2c-3d4e-7f5a-8b9c-0123456789ab",
"communication_type": {"id": 1, "code": "WIFI"},
"login": "MyNetwork",
"password_set": true,
"access_address": "192.168.1.1",
"is_active": true,
"documents_count": 0
}
}
GET Lista komunikacji
▶Pobierz wszystkie komunikacje nieruchomości.
GET /api/v1/properties/{id}/communications
Parametry zapytania:
Odpowiedź (200 OK):
{
"data": [
{
"id": 1,
"communication_type": {"id": 1, "code": "WIFI"},
"login": "MyNetwork",
"password_set": true,
"access_address": "192.168.1.1",
"is_active": true,
"is_currently_active": true,
"documents_count": 1
}
],
"total": 5
}
PUT Zaktualizuj komunikację
▶Zaktualizuj dowolne pola komunikacji. Wyślij tylko te pola, które chcesz zmienić.
PUT /api/v1/communications/{communicationId}
Dostępne pola (wysyłaj tylko te, które chcesz zmienić):
Treść żądania:
{
"login": "NewNetwork_5G",
"password": "new-wifi-pass-2026",
"access_address": "192.168.1.1",
"information": "<h3>Updated Router Info</h3><p>Speed: 1 Gbps</p>",
"is_active": true
}
Pole `information` obsługuje formatowanie HTML (tabele, listy, nagłówki, akapity, linki, style inline). Ze względów bezpieczeństwa cały HTML jest oczyszczany na serwerze — skrypty, iframe, procedury obsługi zdarzeń i niebezpieczne atrybuty są automatycznie usuwane.
POST Dołącz dokument
▶Dołącz istniejący dokument nieruchomości do komunikacji. Dokument musi należeć do tej samej nieruchomości.
POST /api/v1/communications/{communicationId}/documents
Treść żądania:
{
"document_id": 50,
"comment": "Provider contract"
}
Odpowiedź (201 Created):
{
"message": "Document attached successfully",
"data": {
"link_id": 12,
"document_id": 50,
"comment": "Provider contract"
}
}
Odłącz dokument
DELETE /api/v1/communications/{communicationId}/documents/{documentId}
Przykłady cURL
▶1. Utwórz komunikację
curl -X POST https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/communications \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"communication_type_id": 1,
"login": "MyNetwork",
"password": "wifi-pass-2026",
"access_address": "192.168.1.1",
"is_active": true
}'
2. Lista komunikacji
curl https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/communications \
-H "Authorization: Bearer YOUR_TOKEN_HERE"
3. Dołącz dokument
curl -X POST https://landlordkeeper.com/api/v1/communications/1/documents \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"document_id": 50,
"comment": "Provider contract"
}'