📦 Dokumentacja API

API REST dla biur nieruchomości i deweloperów — automatyczny import i synchronizacja ofert z zewnętrznych systemów CRM. Oferty pojawiają się na portalu natychmiast po przesłaniu.

Wprowadzenie

Bazowy URL wszystkich endpointów:

https://zaadresowani.pl/api/v1

API używa formatu JSON zarówno dla żądań (Content-Type: application/json), jak i odpowiedzi. Każde żądanie musi zawierać nagłówek autoryzacyjny z kluczem API.

Klucz API wygenerujesz w Panelu konta → Klucze API. Dostępny dla biur nieruchomości i deweloperów.

Autentykacja

Każde żądanie musi zawierać nagłówek Authorization z tokenem Bearer:

Authorization: Bearer TWÓJ_KLUCZ_API

Klucz API jest powiązany z kontem biura lub dewelopera. Wszystkie oferty importowane przez dany klucz trafiają automatycznie na to konto.

Klucz API zapewnia pełny dostęp do zasobów systemu, dlatego należy traktować go jak dane uwierzytelniające (np. hasło).
Nie powinien być przechowywany w publicznych repozytoriach ani udostępniany poza zaufanym środowiskiem.
W przypadku podejrzenia wycieku należy niezwłocznie wygenerować nowy klucz i dezaktywować poprzedni.

Limity zapytań

Każdy klucz API ma przypisany dzienny limit zapytań, ustalany przez administratora portalu. Domyślna wartość to 1 000 zapytań/dzień. Po przekroczeniu limitu API zwraca kod 429 Too Many Requests.

Aktualny stan wykorzystania limitu widoczny jest w Panelu konta → Klucze API.

Kody błędów

Kod HTTP	Znaczenie
`200`	OK — zapytanie zakończone sukcesem
`201`	Created — oferta została utworzona
`400`	Bad Request — nieprawidłowy JSON lub brakujące pola
`401`	Unauthorized — brak lub nieważny klucz API
`404`	Not Found — oferta o podanym `ref` nie istnieje
`409`	Conflict — oferta o tym `ref` już istnieje (użyj PUT)
`422`	Unprocessable — błąd walidacji; szczegóły w polu `error`
`429`	Too Many Requests — przekroczono dzienny limit zapytań

Każda odpowiedź zawiera pole success (bool) oraz opcjonalnie error z opisem błędu:

{ "success": false, "error": "Pole title jest wymagane", "code": 422 }

GET — Pobierz ofertę

GET /api/v1/listings/{ref}

Zwraca dane oferty identyfikowanej numerem ref z Twojego CRM.

Przykład

cURLcurl -X GET \ https://zaadresowani.pl/api/v1/listings/CRM-12345 \ -H "Authorization: Bearer TWÓJ_KLUCZ_API"

Odpowiedź 200

{ "success": true, "listing": { "id": 42, "external_ref": "CRM-12345", "title": "Mieszkanie 3 pokoje, Poznań", "price": 450000, "area": 68.5, "status": "active", "images": ["https://cdn.crm.pl/foto1.jpg"] } }

POST — Utwórz ofertę

POST /api/v1/listings

Tworzy nową ofertę. Pole ref to unikalny identyfikator z Twojego CRM — służy do późniejszej aktualizacji i usuwania. Oferta trafia od razu ze statusem aktywnym.

Nagłówki

Content-Type: application/json Authorization: Bearer TWÓJ_KLUCZ_API

Ciało żądania

{ "ref": "CRM-12345", // wymagane — unikalny ID z Twojego CRM"title": "Mieszkanie 3 pokoje", "type": "apartment", "deal": "sell", "city": "Poznań", "price": 450000, "area": 68.5, "market": "secondary", "description": "Przestronne mieszkanie w centrum...", "address": "ul. Przykładowa 1", "district": "Jeżyce", "rooms": 3, "floor": 2, "floors_total": 5, "build_year": 1985, "building_type": "blok", "build_material": "wielka płyta", "heating": ["miejskie"], "amenities": ["balkon", "piwnica", "winda"], "media": ["internet", "gaz"], "finish": "do zamieszkania", "ownership": "pełna własność", "lat": 52.4064, "lng": 16.9252, "images": [ "https://cdn.crm.pl/zdjecia/12345/foto1.jpg", "https://cdn.crm.pl/zdjecia/12345/foto2.jpg" ] }

Odpowiedź 201

{ "success": true, "id": 42, "ref": "CRM-12345", "message": "Oferta została utworzona" }

PUT — Zaktualizuj ofertę

PUT /api/v1/listings/{ref}

Aktualizuje istniejącą ofertę. Wszystkie przesłane pola zostają nadpisane. Jeśli podasz tablicę images, stare zdjęcia zostaną zastąpione nowymi.

Przykład

cURLcurl -X PUT \ https://zaadresowani.pl/api/v1/listings/CRM-12345 \ -H "Authorization: Bearer TWÓJ_KLUCZ_API" \ -H "Content-Type: application/json" \ -d '{ "title": "Mieszkanie 3 pokoje — cena obniżona", "price": 420000, "type": "apartment", "deal": "sell", "city": "Poznań" }'

Odpowiedź 200

{ "success": true, "id": 42, "ref": "CRM-12345", "message": "Oferta została zaktualizowana" }

DELETE — Usuń ofertę

DELETE /api/v1/listings/{ref}

Trwale usuwa ofertę i jej zdjęcia. Operacja jest nieodwracalna.

Przykład

cURLcurl -X DELETE \ https://zaadresowani.pl/api/v1/listings/CRM-12345 \ -H "Authorization: Bearer TWÓJ_KLUCZ_API"

Odpowiedź 200

{ "success": true, "ref": "CRM-12345", "message": "Oferta została usunięta" }

Pola oferty

Pole	Typ	Wymagane	Opis
`ref`	string	tak	Unikalny ID oferty w Twoim CRM (maks. 100 znaków)
`title`	string	tak	Tytuł ogłoszenia
`type`	string	tak	Typ nieruchomości — patrz Typy
`deal`	string	tak	`sell` lub `rent`
`city`	string	tak	Miasto (np. `Poznań`)
`price`	number	nie	Cena w PLN
`area`	number	nie	Powierzchnia w m²
`market`	string	nie	`primary` lub `secondary`
`description`	string	nie	Opis oferty
`address`	string	nie	Ulica i numer
`district`	string	nie	Dzielnica
`rooms`	integer	nie	Liczba pokoi
`floor`	integer	nie	Piętro (0 = parter)
`floors_total`	integer	nie	Liczba pięter w budynku
`build_year`	integer	nie	Rok budowy
`building_type`	string	nie	Typ budynku (np. `blok`, `kamienica`)
`build_material`	string	nie	Materiał budowlany
`heating`	string \| array	nie	Ogrzewanie, np. `["miejskie"]`
`amenities`	array	nie	Udogodnienia, np. `["balkon","winda"]`
`media`	array	nie	Media, np. `["internet","gaz"]`
`finish`	string	nie	Stan wykończenia
`ownership`	string	nie	Forma własności
`seller_type`	string	nie	`agency`, `developer` lub `private`
`lat`	number	nie	Szerokość geograficzna (np. `52.4064`)
`lng`	number	nie	Długość geograficzna (np. `16.9252`)
`images`	array	nie	Tablica publicznych URL-ów zdjęć (https). PUT zastępuje poprzednie.

Typy i wartości

type — typ nieruchomości

Wartość	Opis
`apartment`	Mieszkanie
`house`	Dom
`plot`	Działka
`commercial`	Lokal użytkowy
`garage`	Garaż / miejsce parkingowe
`room`	Pokój
`studio`	Kawalerka
`other`	Inne

deal — transakcja

Wartość	Opis
`sell`	Sprzedaż
`rent`	Wynajem

market — rynek

Wartość	Opis
`primary`	Rynek pierwotny
`secondary`	Rynek wtórny

Przykłady kodu

PHP

PHP// Utwórz ofertę $ch = curl_init('https://zaadresowani.pl/api/v1/listings'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode([ 'ref' =>'CRM-99', 'title' =>'Dom jednorodzinny, Warszawa', 'type' =>'house', 'deal' =>'sell', 'city' =>'Warszawa', 'price' =>1200000, 'area' =>180, ]), CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'Authorization: Bearer TWÓJ_KLUCZ_API', ], ]); $resp = json_decode(curl_exec($ch), true); curl_close($ch); echo $resp['success'] ? 'ID: ' . $resp['id'] : $resp['error'];

Python

Pythonimport requests headers = { "Authorization": "Bearer TWÓJ_KLUCZ_API", "Content-Type": "application/json", } BASE = "https://zaadresowani.pl/api/v1"# Utwórz r = requests.post(f"{BASE}/listings", json={ "ref": "PY-001", "title": "Apartament, Kraków", "type": "apartment", "deal": "rent", "city": "Kraków", "price": 3500, }, headers=headers) # Aktualizuj r = requests.put(f"{BASE}/listings/PY-001", json={ "title": "Apartament, Kraków", "type": "apartment", "deal": "rent", "city": "Kraków", "price": 3200, }, headers=headers) # Usuń r = requests.delete(f"{BASE}/listings/PY-001", headers=headers)

Lokale inwestycyjne — wprowadzenie

Oprócz standardowych ofert, API umożliwia import lokali w inwestycjach deweloperskich. Każdy lokal jest przypisany do konkretnej inwestycji i opcjonalnie do jej etapu.

Aby korzystać z endpointów lokali musisz mieć konto dewelopera i mieć dodaną inwestycję w panelu. Inwestycje zarządzasz w Panelu konta → Inwestycje.

Identyfikatory UUID inwestycji i etapów

Każda inwestycja i każdy etap posiadają unikalny identyfikator UUID, który jest wymagany przy wysyłaniu lokali przez API. Znajdziesz je w panelu edycji inwestycji — w sekcji „🔑 Identyfikatory API". Każdy UUID możesz skopiować jednym kliknięciem.

Pole investment_uuid jest zawsze wymagane. Pole phase_uuid jest opcjonalne — jeśli inwestycja ma tylko jeden etap, możesz je pominąć.

Bazowy URL endpointów lokali:

https://zaadresowani.pl/api/v1/units

GET — Pobierz lokal

GET /api/v1/units/{ref}?investment_uuid={uuid}

Zwraca dane lokalu identyfikowanego numerem ref z Twojego CRM w ramach wskazanej inwestycji.

Parametry URL

Parametr	Wymagane	Opis
`ref`	tak	Identyfikator lokalu w Twoim CRM (w URL)
`investment_uuid`	tak	UUID inwestycji (query string)

Przykład

cURLcurl -X GET \ "https://zaadresowani.pl/api/v1/units/M-001?investment_uuid=xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx" \ -H "Authorization: Bearer TWÓJ_KLUCZ_API"

Odpowiedź 200

{ "success": true, "unit": { "id": 15, "uuid": "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx", "external_ref": "M-001", "unit_number": "M.1.01", "rooms": 3, "floor": 1, "area": 62.5, "price": 590000, "show_price": 1, "status": "available" } }

POST — Utwórz lokal

POST /api/v1/units

Tworzy nowy lokal w inwestycji. Pole ref to unikalny identyfikator z Twojego CRM w obrębie danej inwestycji.

Nagłówki

Content-Type: application/json Authorization: Bearer TWÓJ_KLUCZ_API

Ciało żądania

{ "ref": "M-001", // wymagane"investment_uuid": "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx", // wymagane"unit_number": "M.1.01", // wymagane — numer lokalu"unit_type": "mieszkanie", // patrz: słownik unit_types"phase_uuid": "yyyyyyyy-yyyy-4yyy-zyyy-yyyyyyyyyyyy", // opcjonalne"rooms": 3, "floor": 1, "area": 62.5, "price": 590000, "show_price": true, // true = cena publiczna, false = ukryta"status": "available", "description": "Przestronny lokal z widokiem na park", "external_url": "https://twoja-strona.pl/oferta/M-001"// opcjonalnie — link do oferty na Twojej stronie }

Odpowiedź 201

{ "success": true, "id": 15, "ref": "M-001", "investment_uuid": "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx", "phase_uuid": "yyyyyyyy-yyyy-4yyy-zyyy-yyyyyyyyyyyy", "message": "Lokal został utworzony" }

PUT — Zaktualizuj lokal

PUT /api/v1/units/{ref}

Aktualizuje istniejący lokal. Wszystkie przesłane pola zostają nadpisane. Najczęstszy przypadek użycia to zmiana statusu (np. z available na reserved lub sold).

Przykład

cURLcurl -X PUT \ https://zaadresowani.pl/api/v1/units/M-001 \ -H "Authorization: Bearer TWÓJ_KLUCZ_API" \ -H "Content-Type: application/json" \ -d '{ "investment_uuid": "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx", "unit_number": "M.1.01", "status": "reserved", "price": 575000 }'

Odpowiedź 200

{ "success": true, "id": 15, "ref": "M-001", "message": "Lokal został zaktualizowany" }

DELETE — Usuń lokal

DELETE /api/v1/units/{ref}?investment_uuid={uuid}

Trwale usuwa lokal z inwestycji. Operacja jest nieodwracalna.

Przykład

cURLcurl -X DELETE \ "https://zaadresowani.pl/api/v1/units/M-001?investment_uuid=xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx" \ -H "Authorization: Bearer TWÓJ_KLUCZ_API"

Odpowiedź 200

{ "success": true, "ref": "M-001", "message": "Lokal został usunięty" }

Pola lokalu

Pole	Typ	Wymagane	Opis
`ref`	string	tak	Unikalny ID lokalu w Twoim CRM (maks. 100 znaków). Wymagany przy POST; dla PUT podawany w URL.
`investment_uuid`	string	tak	UUID inwestycji — widoczny w Panelu → Inwestycje → Edytuj → sekcja „Identyfikatory API"
`unit_number`	string	tak	Numer / oznaczenie lokalu widoczne na portalu (np. `M.1.01`, `A3`)
`unit_type`	string	nie	Typ lokalu z słownika `unit_types` (patrz Typy lokali). Domyślnie `mieszkanie`.
`phase_uuid`	string	nie	UUID etapu inwestycji — widoczny obok nazwy etapu w sekcji „Identyfikatory API". Pomiń jeśli inwestycja ma jeden etap.
`rooms`	integer	nie	Liczba pokoi
`floor`	integer	nie	Piętro (0 = parter)
`area`	number	nie	Powierzchnia lokalu w m²
`price`	number	nie	Cena w PLN
`show_price`	boolean	nie	`true` — cena widoczna publicznie; `false` — ukryta. Domyślnie `false`.
`status`	string	nie	Status lokalu: `available` (dostępny), `reserved` (zarezerwowany), `sold` (sprzedany). Domyślnie `available`.
`description`	string	nie	Opis lokalu
`external_url`	string (URL)	nie	Link do strony zewnętrznej z ofertą tego lokalu (np. własna podstrona dewelopera). W karcie lokalu na portalu pojawia się przycisk "Zobacz szczegóły" prowadzący do tego URL. Wymagany schemat `http://` lub `https://`, max 500 znaków.

Wartości pola status

Wartość	Opis
`available`	Lokal dostępny — widoczny jako wolny
`reserved`	Lokal zarezerwowany
`sold`	Lokal sprzedany

Pole `show_price`

true — cena lokalu jest publicznie widoczna w karcie inwestycji. false — ukrywamy ją (na portalu pojawia się "Cena na zapytanie"). Domyślnie false. Pole boolean — przyjmuje także wartości 1/0.

Pole `floor_plan_url` (read-only)

Zwracany w odpowiedzi GET. Aby ustawić rzut, użyj POST /api/v1/units/{ref}/floor-plan.

Pole `photos` (read-only)

Zwracany w odpowiedzi GET — tablica obiektów {id, url, sort_order}. Aby dodać zdjęcia użyj POST /api/v1/units/{ref}/photos.

Pole `floors` (read-only)

Zwracany w odpowiedzi GET — tablica kondygnacji wraz z pomieszczeniami. Edytujesz je osobnymi endpointami z sekcji Kondygnacje i pomieszczenia.

Kondygnacje i pomieszczenia — wprowadzenie

Każdy lokal może mieć rozplanowanie wewnętrzne podzielone na kondygnacje (np. parter, piętro, antresola) zawierające pomieszczenia z określonym typem (kuchnia, salon, łazienka itd.) i metrażem. Te dane są wyświetlane w karcie lokalu na portalu.

Workflow:

Stwórz lokal przez POST /api/v1/units i zapamiętaj jego ref.
Stwórz kondygnację przez POST /api/v1/units/{ref}/floors — odpowiedź zwróci floor.id.
Dodaj pomieszczenia do tej kondygnacji przez POST /api/v1/floors/{id}/rooms z room_type ze słownika.

Pełną strukturę (lokal + kondygnacje + pomieszczenia + zdjęcia + rzut) pobierzesz jednym GET /api/v1/units/{ref}.

GET — Lista kondygnacji lokalu

GET /api/v1/units/{ref}/floors?investment_uuid={uuid}

Zwraca wszystkie kondygnacje lokalu, każda z zagnieżdżoną listą pomieszczeń. Kolejność jest zachowana zgodnie z polem sort_order.

Odpowiedź 200

{ "success": true, "floors": [ { "id": 12, "unit_id": 15, "label": "Parter", "sort_order": 0, "rooms": [ { "id": 88, "room_type": 8, "area": 22.5, "sort_order": 0 }, { "id": 89, "room_type": 15, "area": 8.0, "sort_order": 1 } ] } ] }

POST — Dodaj kondygnację

POST /api/v1/units/{ref}/floors

Ciało żądania

{ "investment_uuid": "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx", // wymagane"label": "Parter", // opcjonalne"sort_order": 0// opcjonalne, domyślnie 0 }

Odpowiedź 201

{ "success": true, "floor": { "id": 12, "unit_id": 15, "label": "Parter", "sort_order": 0 } }

PUT — Edytuj kondygnację

PUT /api/v1/floors/{id}

Ciało żądania

{ "label": "Pierwsze piętro", "sort_order": 1 }

Pola opcjonalne — przesyłaj tylko te, które chcesz zmienić.

DELETE — Usuń kondygnację

DELETE /api/v1/floors/{id}

Usuwa kondygnację wraz ze wszystkimi pomieszczeniami które się w niej znajdowały. Operacja nieodwracalna.

POST — Dodaj pomieszczenie

POST /api/v1/floors/{id}/rooms

Ciało żądania

{ "room_type": 8, // wymagane — ID z słownika room_types (1-46)"area": 22.5, // opcjonalne — m²"sort_order": 0// opcjonalne }

Odpowiedź 201

{ "success": true, "room": { "id": 88, "floor_id": 12, "unit_id": 15, "room_type": 8, "area": 22.5, "sort_order": 0 } }

PUT — Edytuj pomieszczenie

PUT /api/v1/rooms/{id}

Ciało żądania

{ "room_type": 15, "area": 9.5, "sort_order": 2 }

Wszystkie pola opcjonalne — przesyłaj tylko te, które chcesz zmienić.

DELETE — Usuń pomieszczenie

DELETE /api/v1/rooms/{id}

POST — Dodaj zdjęcie lokalu

POST /api/v1/units/{ref}/photos

Endpoint przyjmuje multipart/form-data (nie JSON). Pole pliku: photo. investment_uuid przekazuj jako pole formularza lub query string.

Dozwolone formaty: JPG, PNG, WEBP, GIF. Maksymalny rozmiar: 8 MB.

Przykład cURL

cURLcurl -X POST \ https://zaadresowani.pl/api/v1/units/M-001/photos \ -H "Authorization: Bearer TWÓJ_KLUCZ_API" \ -F "investment_uuid=xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx" \ -F "photo=@/sciezka/do/zdjecia.jpg"

Odpowiedź 201

{ "success": true, "photo": { "id": 42, "url": "/uploads/unit_photos/abc123.jpg", "unit_id": 15 } }

DELETE — Usuń zdjęcie lokalu

DELETE /api/v1/photos/{id}

Usuwa rekord zdjęcia oraz plik z dysku.

POST — Dodaj rzut lokalu

POST /api/v1/units/{ref}/floor-plan

multipart/form-data. Pole pliku: floor_plan. Każdy lokal ma jeden rzut — kolejny upload zastępuje poprzedni.

Dozwolone formaty: JPG, PNG, WEBP, GIF (max 8 MB) oraz SVG (max 1 MB) — rzuty wektorowe są zalecane bo skalują się bez utraty jakości.

Pliki SVG przed zapisaniem są sanitowane — usuwane są elementy <script>, <foreignObject>, atrybuty event-handlerów (onclick, onload itd.) oraz hrefy javascript:/data:. Bezpieczne nawet jeśli pochodzą z niezaufanego źródła.

Przykład cURL

cURLcurl -X POST \ https://zaadresowani.pl/api/v1/units/M-001/floor-plan \ -H "Authorization: Bearer TWÓJ_KLUCZ_API" \ -F "investment_uuid=xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx" \ -F "floor_plan=@/sciezka/do/rzutu.png"

Odpowiedź 201

{ "success": true, "floor_plan_url": "/uploads/floor_plans/abc123.png" }

DELETE — Usuń rzut lokalu

DELETE /api/v1/units/{ref}/floor-plan?investment_uuid={uuid}

Czyści floor_plan_url w lokalu i usuwa plik z dysku.

GET — Słowniki

GET /api/v1/dictionaries

Zwraca wszystkie słowniki używane przez API: typy lokali, statusy, typy pomieszczeń, statusy etapów. Pobierz raz przy starcie integracji i cache'uj — zmieniają się rzadko.

Odpowiedź 200

{ "success": true, "unit_types": [ { "code": "mieszkanie", "label": "Mieszkanie" }, { "code": "dom", "label": "Dom" }, { "code": "miejsce_parkingowe", "label": "Miejsce parkingowe" }, // ... ], "unit_statuses": [ { "code": "available", "label": "Dostępny" }, { "code": "reserved", "label": "Zarezerwowany" }, { "code": "sold", "label": "Sprzedany" } ], "room_types": [ { "id": 1, "label": "Przedpokój" }, { "id": 8, "label": "Salon" }, // ... ], "phase_statuses": [ { "code": "planned", "label": "W planach" }, { "code": "selling", "label": "W sprzedaży" }, { "code": "finished", "label": "Zakończony" } ] }

Słownik: Typy lokali (`unit_types`)

Wartości pola unit_type używanego w POST/PUT lokalu.

Kod	Etykieta
`mieszkanie`	Mieszkanie
`dom`	Dom
`miejsce_parkingowe`	Miejsce parkingowe
`garaz`	Garaż
`komorka`	Komórka lokatorska
`lokal_uslugowy`	Lokal usługowy

Słownik: Typy pomieszczeń (`room_types`)

Wartości ID pola room_type używanego przy tworzeniu pomieszczeń. ID są stabilne — bezpiecznie hardkoduj je w integracji.

ID	Etykieta
`1`	Przedpokój
`2`	Przedsionek
`3`	Spiżarnia
`4`	Suszarnia
`5`	Schowek
`6`	Garderoba
`7`	Pokój
`8`	Salon
`9`	Łazienka
`10`	Taras
`11`	Balkon
`12`	Garaż
`13`	Piwnica
`14`	Salon z aneksem
`15`	Kuchnia
`16`	WC
`17`	Sala sprzedaży
`18`	Magazyn
`19`	Kotłownia
`20`	Pomieszczenie techniczne
`21`	Szatnia
`22`	Biuro
`23`	Pomieszczenie socjalne
`24`	Pomieszczenie gospodarcze
`25`	Klatka schodowa
`26`	Korytarz
`27`	Antresola
`28`	Pralnia
`29`	Wnęka
`30`	Komunikacja
`31`	Wiatrołap
`32`	Loggia
`33`	Łazienka + Kotłownia
`34`	Gabinet
`35`	Ogródek
`36`	Podcień
`37`	Garaż - 1 miejsce postojowe
`38`	Pokój dzienny + aneks kuchenny
`39`	Korytarz zewnętrzny
`40`	Pokój dzienny
`41`	Aneks kuchenny
`42`	Schody
`43`	Pralnia + Piec
`44`	Sypialnia
`45`	Salon z jadalnią
`46`	Komórka

📦 Dokumentacja API

Wprowadzenie

Autentykacja

Limity zapytań

Kody błędów

GET — Pobierz ofertę

Przykład

Odpowiedź 200

POST — Utwórz ofertę

Nagłówki

Ciało żądania

Odpowiedź 201

PUT — Zaktualizuj ofertę

Przykład

Odpowiedź 200

DELETE — Usuń ofertę

Przykład

Odpowiedź 200

Pola oferty

Typy i wartości

type — typ nieruchomości

deal — transakcja

market — rynek

Przykłady kodu

PHP

Python

Lokale inwestycyjne — wprowadzenie

Identyfikatory UUID inwestycji i etapów

GET — Pobierz lokal

Parametry URL

Przykład

Odpowiedź 200

POST — Utwórz lokal

Nagłówki

Ciało żądania

Odpowiedź 201

PUT — Zaktualizuj lokal

Przykład

Odpowiedź 200

DELETE — Usuń lokal

Przykład

Odpowiedź 200

Pola lokalu

Wartości pola status

Pole show_price

Pole floor_plan_url (read-only)

Pole photos (read-only)

Pole floors (read-only)

Kondygnacje i pomieszczenia — wprowadzenie

GET — Lista kondygnacji lokalu

Odpowiedź 200

POST — Dodaj kondygnację

Ciało żądania

Odpowiedź 201

PUT — Edytuj kondygnację

Ciało żądania

DELETE — Usuń kondygnację

POST — Dodaj pomieszczenie

Ciało żądania

Odpowiedź 201

PUT — Edytuj pomieszczenie

Ciało żądania

DELETE — Usuń pomieszczenie

POST — Dodaj zdjęcie lokalu

Przykład cURL

Odpowiedź 201

DELETE — Usuń zdjęcie lokalu

POST — Dodaj rzut lokalu

Przykład cURL

Odpowiedź 201

DELETE — Usuń rzut lokalu

GET — Słowniki

Odpowiedź 200

Słownik: Typy lokali (unit_types)

Słownik: Typy pomieszczeń (room_types)

Pole `show_price`

Pole `floor_plan_url` (read-only)

Pole `photos` (read-only)

Pole `floors` (read-only)

Słownik: Typy lokali (`unit_types`)

Słownik: Typy pomieszczeń (`room_types`)