4. Példák¶
Megjegyzés
A megadott példákban nem valós felhasználó nevek és jelszavak vannak. A megadott példák nem feltétlenül naprakészek. Ha ilyet talál, kérem jelezze a fenti e-mail címen!
4.1. Ingatlanok kezelése¶
- Új ingatlan felvétel. Mindegyik ingatlantípusból egy-egy van megadva. Példa
- Ingatlanok módosítása mindegyik képtípusnál.
- Ingatlanok törlése. Példa
- Ingatlanok szinkronizálása. Le lehet kérdezni a szervertől, hogy egy konkrét irodához milyen azonosítójú ingatlanok vannak felvéve. A válaszban az ingatlanok.hu azonosító „id” tagban szerepel, a megadott külső, vagy saját azonosító pedig „atviteli_azonosito” tagban. Példa
- Ingatlan fontosabb adatainak lekérdezése. Példa
4.2. Képek kezelése¶
- Új kép felvétele ingatlanhoz. Példa
- Ingatlan képadatainak módosítása. (sorrend, képhez tartozó szövegek módosítása) Példa
- Ingatlan képek törlése. Példa
- Ingatlan képek szinkronizálása. Le lehet kérdezni a szervertől, hogy egy konkrét ingatlanhoz milyen azonosítójú képek vannak felvéve. A válaszban az ingatlanok.hu azonosító „id” tagban szerepel, a megadott külső, vagy saját azonosító pedig „atviteli_azonosito” tagban. Példa
- Új kép felvétele értékesítőhöz. Példa
- Értékesítő képének módosítása. Példa
- Értékesítő képek törlése. Példa
- Értékesítő képek szinkronizálása. Le lehet kérdezni a szervertől, hogy egy konkrét értékesítőhöz milyen azonosítójú képek vannak felvéve. A válaszban az ingatlanok.hu azonosító „id” tagban szerepel, a megadott külső, vagy saját azonosító pedig „atviteli_azonosito” tagban. Példa
4.4. Értékesítők kezelése¶
- Új értékesítő felvétele az irodához. Példa
- Értékesítő adatlapjának módosítása. Példa
- Értékesítő törlése. Példa
- Értékesítő listázása. Példa
- Értékesítők szinkronizálása. Le lehet kérdezni a szervertől, hogy egy konkrét irodához milyen azonosítójú értékesítők vannak felvéve. A válaszban az ingatlanok.hu azonosító „id” tagban szerepel, a megadott külső, vagy saját azonosító pedig „atviteli_azonosito” tagban. Példa
4.5. Régiók kezelése¶
4.7. Korlátozások¶
- Az elérhető műveletekből legfeljebb 100 darabot lehet megadni egy XML kérésben. Így például ha 327 darab ingatlant szeretnénk felvenni, akkor legalább 4 kérést kell küldeni a szervernek.
- Egy órán belül legfeljebb 100 (1-es, vagy 2-es típusú) hibás xml kérést lehet elküldeni az api felé egy IP címről. Ennek bevezetésére a terheltség elosztás miatt van szükség. Ezen korlát túllépése esetén az api a további kérésekre „standard” hibát ad 12-es kóddal.
- Egy ingatlan módosítására az ingatlan_modositasa parancs használata ajánlott. A hirdetés rövid időn belüli törlését és újra létrehozását a rendszer duplikációként érzékeli.