Jelen API segítségével az ingatlannyilvantartas.hu és az origoingatlan.hu adminisztrációs felületének egyes műveleteit lehet végrehajtani XML formátumban küldött parancsok segítségével.
A végrehajtandó XML-eket az XML feldolgozó szkriptnek kell átadni. Elküldés módja:
HTTP POST metódussal: Ekkor a küldendő XML-t fájlként (multipart/form-data formában) az "origoxml" paraméterben, ill. néven kell elküldeni.
Az XML-eknek UTF-8-as kódolásúnak kell lenni, és "kényes"
elemek (amely elemekben az XML értelmezők számára speciális karakter
pl. '&', '<' stb. szerepelhet) tartalmát kérjük '<![CDATA[' és ']]>' karakterek közé tenni.
Minden XML fájl eleje a hitelesítés résszel kezdődik. Fontos: Itt az adminisztrációs felülethez szükséges Iroda bejelentkezési név, Iroda jelszó,Ügyintéső bejelentkezési név és jelszó párost kell megadni.
A jelszót SHA12 kódolással kell ellátni.
Fontos: Az elérhető műveletekből legfeljebb 1 darabot lehet megadni egy XML kérésben.
Új ingatlan felvétele, módosítása:
A két művelet azonos. Mivel irodánként az IngatlanKOD menzőnek egyedinek kell lennie ezért ha egy adott azonosítójú ingatlan már létezik akkor a rendszer automatikusan a módosítás ágra kerül.
példák:használt lakóingatlan1új lakóingatlan1
Ingatlanok listázása (Ez az exportnak felel meg) Csak meghatározott IP címekről érhető el. A teszt rendszerben nincs IP szűrés.példa1
Települések kezelése
A rendszerben használt települések listázása. példa1
Változások
2009.04.16. XML API béta verzió telepítése
2009.05.08. Amennyiben 1 db fotó van az ingatlanhoz, azt csak a KiemeltFoto tag-ben kell szerepeltetni.
2009.06.02. Elindult az éles üzem az Origo API 1.0-ás változatával.
Kapcsolat
Probléma, kérdés, észrevétel esetén kérjük írjon az info@dis.hu email címre. Telefon: (1) 477-97-00 munkanapokon 9:00 - 17:00-ig.
1: A megadott példák nem feltétlenül naprakészek.
Ha ilyet talál, kérem jelezze a fenti e-mail címen!
2: Az SHA-1 algoritmus specifikációja a http://www.apps.ietf.org/rfc/rfc3174.html
címen érhető el.