Importní rozhraní

Služba určená pro import veřejných dat do aplikací třetích stran z ReeGO24. Například pro import na vaše stránky a nebo jiné projekty většího rozsahu.

Náročnost nasazení:

odbornější přístup
Časová náročnost nasazení:
několik hodin


  1. Funguje na principu získávání XML dat ze serverů ReeGO.
  2. Časová náročnost nasazení služby může být řádově několik hodin až dní a vyžaduje odbornější znalosti v oblasti programingu.

© ReeGO Development s.r.o.
Všechny dokumenty nacházející se v této sekci slouží jako manuál a technická dokumentace pro zákazníky systémů ReeGO. Žádná část manuálu nesmí být kopírována ani přenášena jakýmkoliv způsobem (elektronicky, mechanicky, fotograficky či jinak), ani uveřejněna bez předchozí dohody a písemného svolení ReeGO Development s.r.o. Výjimku tvoří pouze zdrojové kódy příkladů, které pro účely tvorby programového kódu mohou být kopírovány i měněny.

Získání detailu nabídky

Pro získání detailních informací o nabídce je nutné znát její identifikátor. Detail bude generován voláním na známé URL: http://xml.reego.cz/get_XML.php?cust_name=jméno_databáze&cust_pass=heslo. Na místo parametru list, který se používá pro získání seznamů, přidejte parametr advert_id s hodnotou identifikátoru nabídky. Identifikátor nabídky získáte z  elementu <advent_id> ve výpisu nabídek.

Tento detail by měl klient volat tehdy, zaregistruje-li změnu v časovém razítku od posledního volání seznamu nabídek. Časové razítko by si měl klient udržovat i na své straně a po každém volání seznamů jej porovnávat s časovým razítkem na straně serveru. Časové razítko poslední změny nabídky lze získat v seznamu nabídky prostřednictvím elementu <last_edit> nebo <last_edit_unix> v unixovém tvaru. Časové razítko na straně serveru se aktualizuje při přidání, editaci i výmazu nabídky. U operace výmazu není nutné aktualizovat detail nabídky. Proto XML detail u neaktivních (archivovaných) nabídek vrací chybové hlášení, že nabídka neexistuje. Detaily vymazaných nabídek doporučujeme už nevolat. O existenci nabídky informuje element <status> v seznamu nabídek. Popis hodnot elementu <status> naleznete v kapitole číselníky.



Příklad URL pro detail nabídky ID:144:

http://xml.reego.cz/get_XML.php?cust_name=jméno_databáze&cust_pass=heslo&advert_id=144


Demonstrativní příklad XML detailu nabídky. Uvedené hodnoty jsou fiktivní. Struktura nemusí odpovídat skutečnosti. Příklad vychází z verze 1.0. Aktuání struktury a číselníky hodnot naleznete v kapitolách XML stuktury a číselníky hodnot.


Příklad XML detailu nabídky (hodnoty v XML jsou fiktivní a strom vychází z verze 1.0. Nemusí proto odpovídat skutečnosti):

  <?xml version="1.0" ?>
- <root>
- <advert_detail>
  <advert_id>105</advert_id>
  <last_edit>2009-11-27 08:27:41</last_edit>
  <last_edit_unix>1259306861</last_edit_unix>
  <status>1</status>
  <advert_function>1</advert_function>
  <advert_type>4</advert_type>
  <seller_rkid>21</seller_rkid>
  <office>1</office>
  <rkid>R1244</rkid>
  <birthday>2009-11-26 15:09:13</birthday>
  <pay_type>0</pay_type>
  <advert_title>DB 2+kk Líšeň, CP 56 m2, 2.p./5, balkon, novostavba</advert_title>
  <advert_title_en />
  <advert_title_ge />
  <basic_description>DB 2+kk, CP 56 m2. Byt se nachází ve 2 p./5 cihlové novostavby s výtahem z roku 2005, orientace bytu je na západ, plastová okna, na podlahách dlažba a plovoucí, v bytě zůstává kuchyňská linka, z obývacího pokoje vstup na balkon, k bytu náleží sklep.
  </basic_description>
  <basic_description_en />
  <basic_description_ge />
  <advert_price>1750000</advert_price>
  <advert_price_currency>1</advert_price_currency>
  <advert_price_unit>1</advert_price_unit>
  <advert_price_noshow>0</advert_price_noshow>
  <uir>637866</uir>
  <uir_level>7</uir_level>
  <gps_n>49.28819002</gps_n>
  <gps_e>17.00785575</gps_e>
  <flat_kind>2+kk</flat_kind>
  <floor_number>2</floor_number>
  <floors>5</floors>
  <floor_area>56</floor_area>
  <building_type>2</building_type>
  <building_condition>6</building_condition>
  <ownership>2</ownership>
  <rent_building_type>2</rent_building_type>
  <object_location>2</object_location>
  <flat_core>2</flat_core>
  <underground_floors>1</underground_floors>
  <balcony_area>1</balcony_area>
  <loggie_area>0</loggie_area>
  <flat_facilities>011</flat_facilities>
  <heating>00010000</heating>
  <transport>11111</transport>
  <water>010</water>
  <gully>10</gully>
  <gas>01</gas>
  <facilities>111111</facilities>
- <photos>
- <photo>
  <picture_id>1254</picture_id>
  <description>Obrázek k zakázce č.: 12</description>
  <description_en />
  <title_flag>1</title_flag>
  <primary_flag>0</primary_flag>
  <secondary_flag>0</secondary_flag>
  <order>0</order>
  <url_mini>http://www.reego.cz/pic.php?id=20012126210605_713.jpg&format=mini&no_sess</url_mini>
  <url_tn>http://www.reego.cz/pic.php?id=20081114015641_161.jpg&format=tn&no_sess</url_tn>
  <url_large>http://www.reego.cz/pic.php?id=20081114015641_161.jpg &format=normal&no_sess&cust_name=reego_demo</url_large>
  </photo>
  </photos>
- <public_documents>
  <advert_pdf>http://www.reego.cz/advert_pdf.php?id=19&cust_name=reego_demo</advert_pdf>
- <other_public_documents>
  <mime_type>audio/mpeg</mime_type>
  <content_type>Audio</content_type>
  <name>pěkný song</name>
  <url_doc>http://www.reego.cz/public_doc.php?id=101&cust_name=reego_demo</url_doc>
  </other_public_documents>
- <other_public_documents>
  <mime_type>audio/mpeg</mime_type>
  <content_type>Audio</content_type>
  <name>pěkný song 1</name>
  <url_doc>http://www.reego.cz/public_doc.php?id=102&cust_name=reego_demo</url_doc>
  </other_public_documents>
  </public_documents>
  </advert_detail>
  </root>