Ingatlanadatok átadása külső rendszernek
Egy külső program (például CRM vagy hirdetési rendszer) API-kulccsal lekérheti az ingatlanok listáját, egy ingatlan teljes adatlapját és a fotóit.
Ha egy külső program — például egy ügyfélkezelő vagy hirdetésfeladó rendszer — rendszeresen át akarja venni az ingatlanok adatait, ezt a rendszer ingatlan-interfésze teszi lehetővé. Menüpontja nincs: a külső program egy felhasználó API-kulcsával kéri le az adatokat, és csak akkor kap választ, ha ennek a felhasználónak van ingatlan-exportálási joga.
Mit kap a külső program?
- Ingatlanlista: az ingatlanok azonosítója, saját azonosítója, állapota és utolsó módosítása. Kérhető csak az egy adott időpont óta módosult ingatlanok listája is; egy kérés legfeljebb 500 sort ad.
- Adatlap: típus és hasznosítás, címek és leírások minden nyelven, cím és térképi koordináta, területek, szobaszám, építési év, emelet, a helyiséglista szintenkénti összesítéssel, a közmű-mérők, a fotók és dokumentumok listája.
- Fotók: a fotó letölthető JPEG-képként, legfeljebb 2048 képpont méretben.
A kapcsolat beállítása
- Döntse el, melyik felhasználó nevében fut a kapcsolat, és adja át az API-kulcsát a külső program üzemeltetőjének.
- Ennek a felhasználónak a Users → Permissions menüben adja meg az ingatlanok exportálási funkcióját. E nélkül a külső program a „Permission denied.” választ kapja.
- Ellenőrizze, hogy a fotók és dokumentumok cégei a felhasználó API-hatókörébe esnek: csak ezek fájljai kerülnek át.
- Kérje meg a külső program üzemeltetőjét, hogy rendszeresen (például óránként) csak a legutóbbi lekérés óta módosult ingatlanokat kérje le, majd ezek adatlapját és fotóit.
Mire figyeljen?
Érvénytelen kulcsnál a válasz: „Invalid or missing API key.”; nem létező ingatlannál: „The property was not found.”
Példa
A Minta Ingatlan Kft. ügyfélkezelője óránként lekéri a 2026. 11. 01. 08:00 óta módosult ingatlanokat. Egy változott ingatlan adatlapjából átveszi a magyar, angol és német címet, a 85 m² nettó területet és a 8 fotó letöltési címét, majd a fotókat egyenként JPEG-ként letölti.