2 Immobilie beschreiben
Füllen Sie die Details aus: Beschreibung, Fläche, Merkmale und andere wichtige Informationen
Warum ist das wichtig?
Eine gut beschriebene Immobilie hilft Ihnen, alle wichtigen Details im Blick zu behalten, erleichtert die Vertragsvorbereitung und gibt ein vollständiges Bild Ihres Portfolios.
Eine detaillierte Beschreibung ermöglicht:
- Schnell die richtige Immobilie anhand der Merkmale finden
- Mietanzeigen mit allen erforderlichen Details vorbereiten
- Immobilien in Ihrem Portfolio vergleichen
- Alle technischen Informationen an einem Ort aufbewahren
Wie man eine Immobilie bearbeitet
Öffnen Sie eine Immobilie aus Ihrer Liste und klicken Sie auf „Bearbeiten". Sie sehen ein Formular mit allen verfügbaren Feldern.
Gehen Sie zu „Immobilien" → wählen Sie eine Immobilie → klicken Sie oben rechts auf „Bearbeiten".
Weitere Details finden Sie im Abschnitt Immobilien in der Bibliothek.
Grundinformationen
Beginnen Sie mit den Grunddaten. Diese Felder werden auf der Karte und in der Liste angezeigt.
Zusätzliche Merkmale
Unterhalb der Grundfelder finden Sie den Abschnitt für zusätzliche Merkmale. Er enthält detaillierte technische Informationen, gruppiert nach Kategorien. Füllen Sie nur aus, was für Ihren Immobilientyp relevant ist.
Allgemeine Informationen zum Gebäude: Baujahr, Typ, Materialien, Stockwerke, Energieklasse.
Details zur Einheit: Zimmer, Bäder, Etage, Balkone, Zustand, Grundriss, Fensterausblick.
Heizung, Warmwasser, Gas, Internet, Klimaanlage, Lüftung und andere Versorgungssysteme.
Einrichtungen in der Nähe: Aufzüge, Entfernung zur U-Bahn, Schule, Kindergarten, Geschäfte, Parks.
Parkmöglichkeiten: Art des Parkens, Anzahl der Plätze, Garagenfläche.
Für Häuser und Grundstücke: Fläche, Zweck, Kategorie, Bodenart, Zaun, Entfernung zu Wasser und Wald.
Zusätzliche Informationen: Möbel, Herdtyp, maximale Bewohnerzahl.
Für Entwickler: REST API
Sie können Immobiliendetails und Merkmale auch über die REST API aktualisieren.
PUT Immobilie aktualisieren
▶Aktualisieren Sie die Grundfelder: Beschreibung, Fläche, Adressdetails. Senden Sie nur die Felder, die Sie ändern möchten.
PUT /api/v1/properties/{id}
Header:
Authorization: Bearer {token}
Content-Type: application/json
Anfragekörper:
{
"description": "Cozy 2-room apartment in the city center, 5th floor",
"living_area": 45.5,
"total_area": 68.0,
"apartment_number": "42"
}
Antwort (200 OK):
{
"message": "Property updated successfully",
"data": {
"id": "019a1b2c-3d4e-7f5a-8b9c-0123456789ab",
"name": "My Apartment",
"description": "Cozy 2-room apartment in the city center, 5th floor",
"living_area": "45.50",
"total_area": "68.00"
}
}
GET Verfügbare Merkmalcodes
▶Bevor Sie Merkmale setzen, rufen Sie die Liste der verfügbaren Codes und deren Datentypen ab. Jeder Code gehört zu einer Gruppe (building, apartment, utilities usw.).
GET /api/v1/property-data-types/grouped
Antwort (200 OK):
{
"data": {
"building": [
{"code": "FLOOR_COUNT", "data_type": "int", "unit": null},
{"code": "YEAR_BUILT", "data_type": "int", "unit": null},
{"code": "BUILDING_TYPE", "data_type": "string", "unit": null}
],
"apartment": [
{"code": "ROOM_COUNT", "data_type": "int", "unit": null},
{"code": "FLOOR_NUMBER", "data_type": "int", "unit": null}
],
"utilities": [...],
"infrastructure": [...],
"parking": [...],
"land": [...]
},
"groups": ["building", "apartment", "utilities", ...]
}
Um die zulässigen Werte für einen bestimmten Code zu sehen (z.B. Aufzählungsfelder wie BUILDING_TYPE), rufen Sie dessen Details ab:
GET /api/v1/property-data-types/BUILDING_TYPE
Antwort (200 OK):
{
"code": "BUILDING_TYPE",
"data_type": "string",
"group_code": "building",
"constraints": {
"allowedValues": ["panel", "brick", "monolith", "wood",
"block", "foam_block", "frame", "mixed", "other"]
}
}
PUT Merkmale aktualisieren
▶Verwenden Sie den Batch-Endpunkt, um mehrere Merkmale gleichzeitig zu setzen. Werte werden als Code-Wert-Paare übergeben.
PUT /api/v1/properties/{id}/data-values/batch
Anfragekörper:
{
"values": {
"ROOM_COUNT": "3",
"FLOOR_NUMBER": "5",
"FLOOR_COUNT": "9",
"YEAR_BUILT": "2015",
"BUILDING_TYPE": "brick",
"HEATING_TYPE": "central",
"APARTMENT_CONDITION": "euro_repair",
"BATHROOM_COUNT": "1",
"BALCONY_COUNT": "1",
"ELEVATOR_COUNT": "2"
}
}
Antwort (200 OK):
{
"message": "Values updated successfully",
"updated": 10,
"removed": 0,
"errors": []
}
cURL-Beispiele
▶1. Immobilie aktualisieren
curl -X PUT https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"description": "Cozy 2-room apartment in the city center",
"living_area": 45.5,
"total_area": 68.0,
"apartment_number": "42"
}'
2. Merkmale aktualisieren
curl -X PUT https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/data-values/batch \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"values": {
"ROOM_COUNT": "3",
"FLOOR_NUMBER": "5",
"FLOOR_COUNT": "9",
"BUILDING_TYPE": "brick",
"HEATING_TYPE": "central"
}
}'