Kommunikation & Zugänge | LandlordKeeper

Warum Kommunikation speichern?

Jede Immobilie hat mehrere Dienste und Verbindungen: Internet, Telefon, Alarm, Videoüberwachung, Torzugang, Smart-Home-Systeme. Alle diese Informationen an einem Ort zu organisieren, spart Zeit und verhindert Verwirrung — besonders wenn Sie mehrere Immobilien verwalten oder Zugangsdaten mit Mietern teilen müssen.

Was Sie organisieren können

WiFi- und Internetanbieter-Zugangsdaten
Zugang zu Alarm- und Videoüberwachungssystemen
Smart-Home- und Tor-Fernbedienungseinstellungen
TV- und Telefondienstdetails
Angehängte Verträge und Anleitungen für jeden Dienst

Welche Informationen speichern

Jeder Kommunikationsdatensatz kann folgende Informationen speichern:

communication_type_id Diensttyp (erforderlich)

login Kontoname, SSID oder Benutzername

password Passwort oder Zugangscode (verschlüsselt gespeichert)

access_address URL, IP-Adresse oder Webpanel-Link

information Notizen im HTML-Format (Anbieter, Tarif usw.)

is_active Aktiv/Inaktiv-Markierung

Über die Speicherung sensibler Daten
Passwörter werden verschlüsselt gespeichert und sind in der Oberfläche standardmäßig ausgeblendet. Sie können das Passwortfeld für WiFi-Codes, Alarm-PINs und ähnliche Zugangsdaten verwenden, wir empfehlen jedoch, das Passwortfeld nur für unkritische Codes zu nutzen. Für besonders sensible Zugangsdaten sollten Sie einen dedizierten Passwort-Manager verwenden. Der Dienst speichert Daten sicher, aber jeder Benutzer entscheidet selbst, welche Informationen gespeichert werden.

So fügen Sie Kommunikation hinzu

Sie können Kommunikation über die Weboberfläche oder über die API hinzufügen und verwalten.

In der Weboberfläche: Öffnen Sie die Immobilienseite und klicken Sie dann im Immobilienmenü auf "Kommunikation".

Weitere Informationen finden Sie in der Bibliothek: Kommunikation.

Kommunikationstypen

14 integrierte Typen decken alle gängigen Immobiliendienste ab. Verwenden Sie GET /api/communication-types für die vollständige Liste mit IDs.

WIFI WiFi-Netzwerk

INTERNET_FIBER Glasfaser-Internet

STARLINK Starlink-Satelliteninternet

TV_IPTV / TV_SATELLITE Fernsehen (IPTV / Satellit)

VIDEO_SURVEILLANCE Videoüberwachung (CCTV)

ALARM_SYSTEM Alarm- / Sicherheitssystem

REMOTE_GATE Tor / Schranke

SMART_HOME Smart-Home-System

PHONE_WIRED / PHONE_WIRELESS Festnetz- / Mobiltelefon

OTHER_COMMUNICATION Jeder andere Dienst

Angehängte Dokumente

Jeder Kommunikation können Dokumente angehängt werden — Verträge, Anleitungen, Rechnungen. Laden Sie das Dokument zuerst zur Immobilie hoch (POST /api/properties/{id}/documents), dann hängen Sie es an die Kommunikation per Dokument-ID an.

Beispieldokumente

Internetanbietervertrag
Installationsanleitung für Alarmsystem
Smart-Home-App-Einrichtungsanleitung
Tor-Fernbedienung Programmieranleitung

Für Entwickler: REST API

Verwalten Sie Immobilienkommunikation über die REST-API. Das Feld information unterstützt HTML zur Formatierung.

GET Kommunikationstypen abrufen

▶

Die Liste aller verfügbaren Kommunikationstypen mit ihren IDs abrufen.

GET /api/v1/communication-types

Antwort (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 Kommunikation erstellen

▶

Einen neuen Kommunikationsdatensatz für eine Immobilie erstellen. Nur communication_type_id ist erforderlich, alle anderen Felder sind optional.

POST /api/v1/properties/{id}/communications

Header:

                    Authorization: Bearer {token}
Content-Type: application/json
                

Anfragekörper:

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

Das Feld information akzeptiert HTML. Verwenden Sie <p>, <b>, <ul>/<li>-Tags für strukturierten Inhalt.

Das Feld `information` unterstützt HTML-Formatierung (Tabellen, Listen, Überschriften, Absätze, Links, Inline-Styles). Aus Sicherheitsgründen wird das gesamte HTML auf dem Server bereinigt — Skripte, Iframes, Event-Handler und gefährliche Attribute werden automatisch entfernt.

Antwort (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 Kommunikation auflisten

▶

Alle Kommunikationen einer Immobilie abrufen.

GET /api/v1/properties/{id}/communications

Abfrageparameter:

active_only Nur aktive Kommunikationen anzeigen (true/false)

Antwort (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 Kommunikation aktualisieren

▶

Beliebige Felder einer Kommunikation aktualisieren. Senden Sie nur die Felder, die Sie ändern möchten.

PUT /api/v1/communications/{communicationId}

Verfügbare Felder (senden Sie nur die, die Sie ändern möchten):

login string | null

password string | null

access_address string | null

information string (HTML) | null

is_active boolean

Anfragekörper:

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

Verwenden Sie die Kommunikations-ID aus der Antwort der Liste (GET) oder Erstellung (POST).

Das Feld `information` unterstützt HTML-Formatierung (Tabellen, Listen, Überschriften, Absätze, Links, Inline-Styles). Aus Sicherheitsgründen wird das gesamte HTML auf dem Server bereinigt — Skripte, Iframes, Event-Handler und gefährliche Attribute werden automatisch entfernt.

POST Dokument anhängen

▶

Ein vorhandenes Immobiliendokument an eine Kommunikation anhängen. Das Dokument muss zur gleichen Immobilie gehören.

POST /api/v1/communications/{communicationId}/documents

Anfragekörper:

{
  "document_id": 50,
  "comment": "Provider contract"
}

Laden Sie das Dokument zuerst zur Immobilie hoch (POST /api/properties/{id}/documents), dann hängen Sie es hier mit der zurückgegebenen Dokument-ID an.

Antwort (201 Created):

                    {
  "message": "Document attached successfully",
  "data": {
    "link_id": 12,
    "document_id": 50,
    "comment": "Provider contract"
  }
}
                

Dokument abhängen

DELETE /api/v1/communications/{communicationId}/documents/{documentId}

Entfernt die Verknüpfung zwischen Kommunikation und Dokument. Das Dokument selbst wird nicht gelöscht.

cURL-Beispiele

▶

1. Kommunikation erstellen

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. Kommunikation auflisten

curl https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/communications \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

3. Dokument anhängen

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

Ersetzen Sie YOUR_TOKEN_HERE durch den JWT-Token aus dem Authentifizierungsschritt.

6 Kommunikation & Zugänge

Warum Kommunikation speichern?

Was Sie organisieren können

Welche Informationen speichern

So fügen Sie Kommunikation hinzu

Kommunikationstypen

Angehängte Dokumente

Beispieldokumente

Für Entwickler: REST API

GET Kommunikationstypen abrufen

GET /api/v1/communication-types

Antwort (200 OK):

POST Kommunikation erstellen

POST /api/v1/properties/{id}/communications

Header:

Anfragekörper:

Antwort (201 Created):

GET Kommunikation auflisten

GET /api/v1/properties/{id}/communications

Abfrageparameter:

Antwort (200 OK):

PUT Kommunikation aktualisieren

PUT /api/v1/communications/{communicationId}

Verfügbare Felder (senden Sie nur die, die Sie ändern möchten):

Anfragekörper:

POST Dokument anhängen

POST /api/v1/communications/{communicationId}/documents

Anfragekörper:

Antwort (201 Created):

Dokument abhängen

DELETE /api/v1/communications/{communicationId}/documents/{documentId}

cURL-Beispiele

1. Kommunikation erstellen

2. Kommunikation auflisten

3. Dokument anhängen