2 Opis nieruchomości
Uzupełnij szczegóły: opis, powierzchnię, cechy i inne ważne informacje o nieruchomości
Dlaczego to ważne?
Dobrze opisana nieruchomość pomaga śledzić wszystkie ważne szczegóły, ułatwia przygotowanie umów i ogłoszeń, i daje pełny obraz portfela nieruchomości.
Szczegółowy opis pozwala:
- Szybko znaleźć odpowiednią nieruchomość po cechach
- Przygotować ogłoszenia najmu ze wszystkimi potrzebnymi szczegółami
- Porównywać nieruchomości w swoim portfolio
- Przechowywać wszystkie informacje techniczne w jednym miejscu
Jak edytować nieruchomość
Otwórz dowolną nieruchomość z listy i kliknij przycisk „Edytuj". Zobaczysz formularz ze wszystkimi dostępnymi polami do wypełnienia.
Przejdź do „Nieruchomości" → wybierz nieruchomość → kliknij „Edytuj" w prawym górnym rogu.
Więcej szczegółów w sekcji Nieruchomości w Bibliotece.
Podstawowe informacje
Zacznij od uzupełnienia podstawowych danych. Te pola wyświetlane są na karcie i w liście nieruchomości.
Dodatkowe cechy
Poniżej podstawowych pól znajdziesz sekcję dodatkowych cech. Zawiera szczegółowe informacje techniczne, zorganizowane w grupy. Wypełnij tylko to, co dotyczy twojego typu nieruchomości.
Ogólne informacje o budynku: rok budowy, typ, materiały, liczba pięter, klasa energetyczna.
Szczegóły lokalu: pokoje, łazienki, piętro, balkony, stan, układ, widok z okien.
Ogrzewanie, ciepła woda, gaz, internet, klimatyzacja, wentylacja i inne systemy.
Obiekty w pobliżu: windy, odległość do metra, szkoły, przedszkola, sklepów, parków.
Opcje parkowania: typ parkingu, liczba miejsc, powierzchnia garażu.
Dla domów i działek: powierzchnia, przeznaczenie, kategoria, typ gleby, ogrodzenie, odległość do wody i lasu.
Dodatkowe informacje: meble, typ kuchenki, maksymalna liczba mieszkańców.
Dla programistów: REST API
Możesz również aktualizować szczegóły i cechy nieruchomości przez REST API.
PUT Aktualizacja nieruchomości
▶Zaktualizuj podstawowe pola: opis, powierzchnię, szczegóły adresu. Wyślij tylko pola, które chcesz zmienić.
PUT /api/v1/properties/{id}
Nagłówki:
Authorization: Bearer {token}
Content-Type: application/json
Treść żądania:
{
"description": "Cozy 2-room apartment in the city center, 5th floor",
"living_area": 45.5,
"total_area": 68.0,
"apartment_number": "42"
}
Odpowiedź (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 Dostępne kody cech
▶Przed ustawieniem cech pobierz listę dostępnych kodów i ich typów danych. Każdy kod należy do grupy (building, apartment, utilities itp.).
GET /api/v1/property-data-types/grouped
Odpowiedź (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", ...]
}
Aby zobaczyć dozwolone wartości dla konkretnego kodu (np. pól wyliczeniowych jak BUILDING_TYPE), pobierz jego szczegóły:
GET /api/v1/property-data-types/BUILDING_TYPE
Odpowiedź (200 OK):
{
"code": "BUILDING_TYPE",
"data_type": "string",
"group_code": "building",
"constraints": {
"allowedValues": ["panel", "brick", "monolith", "wood",
"block", "foam_block", "frame", "mixed", "other"]
}
}
PUT Aktualizacja cech
▶Użyj endpointu batch, aby ustawić wiele cech jednocześnie. Wartości przekazywane są jako pary kod-wartość.
PUT /api/v1/properties/{id}/data-values/batch
Treść żądania:
{
"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"
}
}
Odpowiedź (200 OK):
{
"message": "Values updated successfully",
"updated": 10,
"removed": 0,
"errors": []
}
Przykłady cURL
▶1. Aktualizacja nieruchomości
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. Aktualizacja cech
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"
}
}'