Az Ingatlannet.hu áttöltési felületének használata

Ingatlannet.hu API

Az Ingatlannet.hu lehetőséget nyújt más ingatlanportálokon tárolt hirdetések automatikus áttöltésére. Ehhez mindössze az alábbi szekciókban definiált xml formára kell hoznia adatait. Amennyiben ez a file nyilvánosan elérhető az interneten, vegye fel a kapcsolatot ügyfélszolgálatunkkal. A szerződést követően a megadott webcím bekerül az Ingatlannet.hu API partnerlistájába, és tartalmát napi rendszerességgel szinkronizáljuk.

Formátum

Az alábbi táblázat az xml file-ban megadható érvényes mezők listája, sorrendjük kötetlen. Ahol a típusban „(DICT)” szerepel, ott a lehetséges értékek listája a szótárban található, ahol pedig „COMP”, ott az elem további elemeket tartalmaz és szerkezeti leírása a komplex elemek szekcióban érhető el.

• A „string” típusú adatokat „<![CDATA[” nyitótaggal és „]]>” zárótaggal kell ellátni.
• Boolean-ként csak a „true”, „True”, „TRUE”, „false”, „False”, „FALSE” értékek fogadhatóak el.

Komplex elemek

• coordinates

  a „coordinates” mező használata opcionális ugyan, de ha meg van adva, akkor a belső szerkezete:

• rooms

  A „rooms” mező használata opcionális ugyan, de ha meg van adva, akkor legalább egy „room” elemet tartalmaznia kell, aminek belső szerkezete:

• pictures

  A „pictures” mező használata opcionális ugyan, de ha meg van adva, akkor legalább egy „picture” elemet tartalmaznia kell. A kép típusa JPG, JPEG, GIF, PNG, TIFF vagy BMP lehet, és legalább 300 × 225 pixel nagyságúnak kell lennie. A képek megjelenésének sorrendje az xml-ben megadott sorrendtől függ. Az adatstruktúra szerkezete:

• descriptions

  A leírásokban előforduló HTML elemeket NEM értelmezzük.

  A „descriptions” mező használata opcionális ugyan, de ha meg van adva, akkor legalább egy „description” elemet tartalmaznia kell, aminek belső szerkezete:

• swap

  A „swap” mező használata opcionális ugyan, de ha meg van adva, akkor belső szerkezete:

• agent

  A referenseket az e-mail címük alapján azonosítjuk, ezért ha az megegyezik az irodáéval ( tehát az ingatlant maga az iroda hirdeti, és nem egy referense ), akkor a referens megadása szükségtelen. Az „agent” mező használata egyébként is opcionális, de ha meg van adva, akkor belső szerkezete:

• office

  Az „office” mező belső szerkezete:

Szótár

A „(DICT)” jelzésű mezőknél csak bizonyos kódokat fogadunk el, ezeket a SZÓTÁR definiálja.

Validáció

Megtudhatja, hogy xml-je megfelelő formátumú-e, ha ellenőrzi az ingatlannethu.xsd-vel.

Validáció menete

1. Látogasson el a http://tools.decisionsoft.com/schemaValidate/ oldalra.
2. Az „XML Schema” mezőbe töltse fel az ingatlannethu.xsd fájlt.
3. Az „XML Instance” mezőbe töltse fel a saját XML dokumentumát.
4. Kattintson a „Validate” gombra.
5. Kattintson a „Click here” linkre.

Ha a „Well Formed: VALID” és a „Schema Validation: VALID” feliratok jelennek meg, az XML-fájl helyes, ha nem, akkor ki kell javítani a felsorolt hibákat.

Minta

A könnyebb átláthatóság érdekében egy MINTÁT is készítettünk, amely bemutatja, hogy hogyan kell elrendezni az adatokat.