SeznamReality Import XML-RPC server

Sreality - XML-RPC IMPORT v1.0

SeznamReality Import XML-RPC server Obsah 1.Úvod..................................................................................................................................... .......................2

1.1 Identifikace inzerátů............................................................................................................................................2

2.Metody........................................................................................................................................................4

getHash(client_id) as struct......................................................................................................................................4 login( session_id as string, password as string, software_key as string ) as struct..................................................4 logout( session_id as string ) as struct.....................................................................................................................4 addAdvert( session_id as string, advert_data as struct, type_data as struct ) as struct...........................................4 delAdvert( session_id as string, advert_id as int, rkid as string ) as struct...............................................................6 listAdvert( session_id as string ) as struct................................................................................................................6 addPhoto( session_id as string, advert_id as int, rkid as string, data as base64, main as int, alt as string, photo_rkid as string, alt_en as string ) as struct.......................................................................................................6 delPhoto( session_id as string, photo_id as int, photo_rkid as string ) as struct......................................................7 listPhoto( session_id as string, advert_id as int, rkid as string ) as struct................................................................7 addMagazine( session_id as string, advert_id as int, rkid as string, description as string ) as struct.......................8 delMagazine( session_id as string, advert_id as int, rkid as string ) as struct..........................................................8 listMagazine( session_id as string ) as struct...........................................................................................................8 addMagazinePhoto( session_id as string, advert_id as int, rkid as string, data as base64 ) as struct.....................8 addSeller( session_id as string, client_name as string, contact_gsm as string, contact_email as string, seller_rkid as string, contact_phone as string, contact_icq as string, makler_note as string, photo as base64 ) as struct.......9 delSeller( session_id as string, seller_id as int, seller_rkid as string ) as struct.......................................................9 listSeller( session_id as string ) as struct..................................................................................................................9 addDevel( session_id as string, devel_data as struct, advert_id as array, rkid as array ) as struct.......................10 delDevel( session_id as string, developer_id as int, devel_rkid as string ) as struct..............................................10 listDevel( session_id as string ) as struct................................................................................................................10 addDevelPhoto( session_id as string, developer_id as int, devel_rkid as string, data as base64, main as int, alt as string, photo_rkid as string ) as struct................................................................................................................11 delDevelPhoto( session_id as string, photo_id as int, photo_rkid as string ) as struct...........................................11 listDevelPhoto( session_id as string, developer_id as int, devel_rkid as string ) as struct.....................................11 statusAdvert( session_id as string, advert_id as array, rkid as array, user_status as int ) as struct......................12 listStat( session_id as string, advert_id as array, rkid as array ) as struct..............................................................12 version( ) as struct..................................................................................................................................................12

3.Datové struktury a číselníky......................................................................................................................14

Inzerát................................................................................................................................................................14 Zemědělské objekty (1).....................................................................................................................................16 Komerční objekty (2)..........................................................................................................................................17 Pozemky (3)......................................................................................................................................................19 Byty (4)..............................................................................................................................................................20 Historické objekty (5).........................................................................................................................................21 Domy a vily (6)...................................................................................................................................................23 Hotely, penziony a restaurace (7)......................................................................................................................24 Nájemní domy (8)..............................................................................................................................................26 Komerční prostory (9)........................................................................................................................................28 Chaty a rekreační objekty (10)...........................................................................................................................30 Malé objekty, garáže (11)..................................................................................................................................31 Developerské projekty (developer)....................................................................................................................32 Společné konstanty...........................................................................................................................................34 Adresy, UIR-ADR..............................................................................................................................................36 Regiony.............................................................................................................................................................37 Error hlášky........................................................................................................................................................41

4.Příklady pro PHP......................................................................................................................................42

PEAR.................................................................................................................................................................42

Seznam.cz, a.s.

1.

Datum: 26.10.2005


  Všechny metody vrací strukturovaný výstup (asociativní pole), který tvoří položky output (výstupní data), status (kód chyby), statusMessage (chyba jako textový řetězec). array(

)

[status] => 200, [statusMessage] => 'OK', [output] => array( )

Veškerá komunikace se serverem a zpět probíhá v kódování UTF-8.

Všem uvedeným metodám je nutno předat všechny specifikované parametry. Pokud je uvedeno, že parametr je nepovinný, stačí jej vyplnit podle typu prázdnou hodnotou. Pro přihlášení se nejprve musí zavolat metoda getHash, které se předá ID, a ta vrátí hashovací klíč, který se použije dále pro metodu login. Metoda login slouží pro potvrzení přihlášení, které se předá zakódované heslo a softwarový klíč. Pokud přihlášení proběhne v pořádku, vrátí metoda status 200. Rozhraní používá MD5 hashování v hexadecimálním tvaru. Serverové rozhraní XML-RPC se nachází na adrese http://import.sreality.cz:443/RPC2. Za výjimečných okolností může dojít v budoucnosti ke změně této adresy.

1.1 Identifikace inzerátů Kdykoliv je použito v parametru metody advert_id a rkid, platí toto pravidlo. Pokud je zadáno advert_id, musí být rkid prázdný řetězec. Pokud je zadáno rkid, musí být advert_id číslo nula. Stejná situace nastává u photo_id X photo_rkid, seller_id X seller_rkid a developer_id X devel_rkid. U rkid lze využít tzv. dvojtečkovou konvenci abc::xyz. Ta je vhodná pro případ, kdy uživatel potřebuje rozlišit veřejný a neveřejný identifikátor zakázky. První část (před ::) je veřejná a zobrazovaná u inzerátu, druhá část slouží pro identifikaci a musí být unikátní v rámci RK. (Příklad 'abc::xyz' == 'def::xyz' <> 'abc::uvx' == 'ghi::uvx') RKID bez '::' je považováno za jednoznačný identifikátor a zároveň je zobrazováno v detailu inzerátu. Názvosloví: •

session_id – řetězec znaků a čísel, který identifikuje konkrétní přihlášení

•

hash – řetězec znaků a čísel, který slouží k zakódování hesla

•

software_key – řetězec, identifikující použitý software

•

advert_data – asociativní pole dat inzerátu

•

type_data – asociativní pole dat specifických dat inzerátu

•

advert_id – jedinečné interní číslo inzerátu

•

photo_id – jedinečné interní číslo fotky

•

seller_id – jedinečné interní číslo makléře Typický průběh komunikace:

•

getHash

•

login

•

listAdvert

Seznam.cz, a.s.

2.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 •

delAdvert

•

…

•

addAdvert

•

addPhoto

•

…

•

logout

Seznam.cz, a.s.

3.

Datum: 26.10.2005


  getHash(client_id) as struct Získání řetězce, který je požit pro hashování hesla.

Metoda slouží k získání řetězce pro hashování hesla. Po zavolání se správným client_id je vrácen status 200 a v output je session_id a hashovací klíč. struct { int status

}

string statusMessage array output ( session_id hashkey )

Status (200=OK, 402=neexistujici client_id) Slovni popis statusu. Identifikace spojeni hashovaci klic

login( session_id as string, password as string, software_key as string ) as struct Potvrzení přihlášení. Heslo se vytvoří pomocí vzorce MD5(MD5('heslo')+hash_key).

Metodě login se předávají parametry session_id (z metody getHash), hashované heslo a softwarový klíč. Softwarový klíč je přidělen administrátorem srealit zvlášť pro každého vývojaře. Nazpět je vrácen status úspěšnosti. struct { int status

string statusMessage array output ( )

Status (200=OK, 402=Neexistujici klient, 403=Spatne heslo, 405=Neplatny klic softwaru, 407=Neplatne prihlaseni, 410=Neplatic, 412=Nemate opravneni vkladat inzerci pres toto rozhrani) Slovni popis statusu.

}

logout( session_id as string ) as struct Odhlášení. struct { int status string statusMessage array output ( ) }

Status (210=Dohlaseni je OK) Slovni popis statusu.

addAdvert( session_id as string, advert_data as struct, type_data as struct ) as struct Přidání / editace inzerátu.

Metodě se předají parametry podle dále definovaných datových struktur Advert a pro adekvátní druh. Zpět je vrácen status a advert_id, které je dobré si uchovat pro další operace s uloženým inzerátem. Pokud je vyplněn parametr rkid, musí být v rámci inzerce konkrétního klienta unikátní. Tento parametr obsahuje vlastní identifikátor inzerátu a tento identifikátor se bude zobrazovat na webovém serveru místo advert_id. Je ho možné také použít při práci s importním rozhraním, kde opět zastupuje advert_id. Editace inzerátu se Seznam.cz, a.s.

4.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 zajistí vyplněním advert_id již uloženého inzerátu, nebo je možno zadat existující rkid (viz. odstavec 1.1). Adresu inzerátu lze vyplnit buď klasicky nebo s použitím UIR-ADR. UIR-ADR má tu výhodu, že se adrese doplní automaticky tak, jak je uvedena v katastru nemovitostí. Více informací je uvedeno v kapitole UIRADR. struct { int status

string statusMessage array output ( int advert_id )

Status (200=OK, 407=Neplatne prihlaseni 452=Nekompletni data k inzeratu, 453=Nekompletni data spec. udaju, 455=Neplatny kod UIR-ADR, 457=Adresa pro tento druh neni kompletni, 461=Makler neexistuje, 480=Chyba pri zapisu nabidky do databaze, 500=Inzerat pro tuto RK neexistuje!) Slovni popis statusu. cislo inzeratu

}

Příklad XML požadavku: <methodCall> <methodName>addAdvert <params> <param> <string>d159ef7629f58c636c740144e26d21ba <param> <struct> <member> user_status 1 <member> advert_function 1 <member> advert_price_unit 1 <member> region_id 500054 <member> title <string>Testovaci pozemek <member> advert_lifetime 30 <member> advert_price 10000 <member> advert_type 3 <member> advert_price_currency 1 <member> advert_city <string>Praha 1

Seznam.cz, a.s.

5.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 <member> basic_description <string>jfsdlkjfslaf saklfsdjflasdklfasjflsklfj sdfl sjdlflalfdls fasldj flasd fj <member> extra_info <string>01 <param> <struct> <member> estate_kind 6 <member> total_area 100 <member> area_unit 2 <member> engineering_networks <string>0001

delAdvert( session_id as string, advert_id as int, rkid as string ) as struct Vymazání inzerátu.

Pomocí advert_id čísla nebo rkid řetězce je inzerát smazán. Uložené fotografie u inzerátu budou smazány. struct { int status

}


Status (200=OK, 407=Neautorizovani pristup 500=Inzerat nenalezen) Slovni popis statusu.

listAdvert( session_id as string ) as struct Výpis všech inzerátů přihlášené realitní kanceláře.

V output je vráceno pole, kde každý prvek pole obsahuje advert_id, rkid, advert_type a user_status. struct { int status

}

string statusMessage array output ( int advert_id string rkid int advert_type int status_user )

Status (200=OK, 407=Neautorizovani pristup) Slovni popis statusu. cislo inzeratu interni cislo realitky druh inzeratu (byty, pozemnky...) podle dokumentace status inzeratu (aktnivni, neaktnivi) podle dokumentace

addPhoto( session_id as string, advert_id as int, rkid as string, data as Seznam.cz, a.s.

6.

Datum: 26.10.2005


base64, main as int, alt as string, photo_rkid as string, alt_en as string ) as struct Vložení fotografie k již uloženému inzerátu.

Vstupními parametry jsou advert_id nebo rkid, JPEG soubor zakódovaný pomocí base64, příznak, zda jde o hlavní či vedlejší fotografie (main = 1 – hlavní, main = 0 – vedlejší, main = 2 - časopis) a český nebo anglický popisek obrázku (alt, alt_en). Fotografie s main hodnotou 2 není zobrazena na webu, slouží pouze pro případné vložení inzerátu do tištěného časopisu. Např. pro fotografii bez vodotisku. Pomocí advert_id nebo rkid se identifikuje inzerát. Vždy má přednost advert_id před rkid (viz. odstavec 1.1). Výstupem je photo_id, které je vhodné si uložit pro mazání fotky. Pokud je vkládána vedlejší fotografie, a přitom není u inzerátu žádná, stává se tato automaticky hlavní fotografií. Pokud je vkládána hlavní fotografie, a přitom u inzerátu již jedna je, stane se hlavní fotografie vedlejší a nová hlavní. Minimální rozlišení fotografie je 640x480 a maximální velikost souboru 100kB. Po překročení této velikosti server vrací chybu a fotografii nezpracuje. Fotografie jsou seřazeny podle pořadí vložení. struct { int status

string statusMessage array output ( int photo_id )

Status (200=OK, 407=Neplatne prihlaseni 500=Inzerat nenalezen, 471=Popisek k fotografii je povinny, 470=Neni to JPEG obrazek) Slovni popis statusu. cislo fotografie

}

delPhoto( session_id as string, photo_id as int, photo_rkid as string ) as struct Vymazání fotografie.

Identifikací fotografie je photo_rkid nebo photo_id, které má přednost. Pokud je mazána hlavní fotografie, hlavní se automaticky stane první vedlejší. struct { int status

}


Status (200=OK, 407=Neplatne prihlaseni 476=Fotografie nenalezena) Slovni popis statusu.

listPhoto( session_id as string, advert_id as int, rkid as string ) as struct Výpis fotografie existujícího inzerátu.

V output je vráceno pole, kde každý prvek pole obsahuje photo_id, main (main = 1 – hlavní fotografie, main = 0 – vedlejší fotografie) a photo_rkid. struct { int status string statusMessage array output ( int photo_id int main string photo_rkid )

Seznam.cz, a.s.

Status (200=OK, 500=Inzerat nenalezen, 407=Neautorizovani pristup) Slovni popis statusu. cislo fotografie hlavni fotografie identifikace fotografie

7.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 }

addMagazine( session_id as string, advert_id as int, rkid as string, description as string ) as struct Přidání existujícího inzerátu do aktuálně připravovaného čísla katalogu.

Inzerátu, který se vloží metodou do časopisu, se hodnoty a údaje (kromě popisku) překopírují z inzerátu (hlavní fotka, cena a zařazení). Inzerát se identifikuje zadáním advert_id nebo rkid (viz. odstavec 1.1). struct { int status


Status (200=OK, 407=Neautorizovani pristup 500=Inzerat nenalezen, 703=Inzerat je jiz v tisku) Slovni popis statusu.

}

delMagazine( session_id as string, advert_id as int, rkid as string ) as struct Odstranění inzerátu z aktuálně připravovaného čísla katalogu.

Odstranění proběhne v případě, pokud ještě neproběhla uzávěrka aktuálního čísla. struct { int status


Status (200=OK, 407=Neautorizovani pristup 500=Inzerat nenalezen, 705=Inzerat neni v tisku) Slovni popis statusu.

}

listMagazine( session_id as string ) as struct Výpis inzerátu v časopisu.

V output je vráceno pole, kde každý prvek pole obsahuje advert_id a advert_type. struct { int status

}

string statusMessage array output ( int advert_id string rkid int advert_type )

Status (200=OK, 407=Neautorizovani pristup) Slovni popis statusu. cislo inzeratu rkid inzeratu druh inzeratu (byty, pozemnky...) podle dokumentace

addMagazinePhoto( session_id as string, advert_id as int, rkid as string, data as base64 ) as struct Přidání fotografie inzerátu vloženého do katalogu.

Metodou lze docílit změny fotografie inzerátu vloženého do katalogu. Původní je vždy přepsána novou. Fotografie se ukládá nezávisle od fotografií zobrazených na webu. Inzerát se identifikuje zadáním advert_id nebo rkid (viz. odstavec 1.1). struct { int status

Seznam.cz, a.s.

Status (200=OK, 407=Neplatne prihlaseni

8.

Datum: 26.10.2005


}

500=Inzerat nenalezen, 470=Neni to JPEG obrazek, 705=Inzerat neni v tisku) Slovni popis statusu.


addSeller( session_id as string, client_name as string, contact_gsm as string, contact_email as string, seller_rkid as string, contact_phone as string, contact_icq as string, makler_note as string, photo as base64 ) as struct Přidání nového makléře.

Aby makléř byl vložen, je potřeba vyplnit tyto povinné položky: session_id, client_name (jméno a přijmení), contact_gsm (mobil), contact_email (email). Seller_rkid je nepovinná položka a slouží též jako identifikátor konkrétního makléře. Je to alternativa k seller_id. Při vkládaní inzerátu, pokud má vlastního makléře, je tedy na výběr mezi seller_rkid a seller_id (viz. odstavec 1.1). Ostatní položky contact_phone (telefon), contact_icq (ICQ), makler_note (poznámka makléře) a photo (fotografie makléře) jsou nepovinné. U korektně vloženého makléře je získáno seller_id číslo. struct { int status s))

}

string statusMessage array output ( int seller_id )

Status (200=OK, 407=Neplatne prihlaseni, 452=Nejsou vyplneny vsechny povinne polozky nebo jsou spatneho typu (% Slovni popis statusu. cislo maklere

delSeller( session_id as string, seller_id as int, seller_rkid as string ) as struct Odebrání existujícího makléře.

Odstranění proběhne při vyplněním seller_id nebo seller_rkid. Parametr seller_id má před seller_rkid přednost. struct { int status string statusMessage array output ( )

Status (200=OK, 407=Neplatne prihlaseni 461=Makler nenalezen) Slovni popis statusu.

}

listSeller( session_id as string ) as struct Výpis inzerátu v časopisu.

V output je vráceno pole, kde každý prvek pole obsahuje seller_id, seller_rkid, client_name a photo. struct { int status string statusMessage array output (

Seznam.cz, a.s.

Status (200=OK, 407=Neautorizovani pristup) Slovni popis statusu.

9.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 int sellerr_id string seller_rkid string client_name int photo

cislo maklere interni cislo rk maklere Jmeno a prijmeni Fotografie 1-ano, 0-ne

) }

addDevel( session_id as string, devel_data as struct, advert_id as array, rkid as array ) as struct Přidání / editace developerského projektu.

Metodě se předají parametry podle dále definovaných datových struktur Developer (devel_data) a pole spárovaných inzerátů za pomoci advert_id nebo rkid. Zpět je vrácen status a developer_id, které je dobré si uchovat pro další operace s uloženým developerským projektem. Pokud je vyplněn parametr devel_rkid, musí být v rámci inzerce konkrétního klienta unikátní. Je ho možné také použít při práci s importním rozhraním, kde opět zastupuje developer_id. Editace inzerátu se zajistí vyplněním developer_id již uloženého projektu, nebo je možno zadat existující devel_rkid (viz. odstavec 1.1). Spárovat k devel. projektu inzerát je též možné v metodě addAdvert vyplněním položek developer_id nebo devel_rkid. Devel. projekt již musí existovat, jinak spárování neproběhne. Při editaci devel. projektu je nutné uvádět v poli parametru advert_id nebo rkid všechny inzeráty, které projektu patří, jinak bude vazba mezi devel. projektem a inzerátem zrušena. struct { int status

}

string statusMessage array output ( int developer_id )

Status (200=OK, 407=Neplatne prihlaseni 452=Nekompletni data k devel. projektu, 500=Inzerat pro tuto RK neexistuje!) Slovni popis statusu. cislo devel. projektu

delDevel( session_id as string, developer_id as int, devel_rkid as string ) as struct Vymazání devel. projektu.

Pomocí developer_id čísla nebo devel_rkid řetězce je devel. projekt smazán. Uložené fotografie budou smazány. Všechny navázané inzeráty zůstanou beze změny, pouze ztratí vazbu na devel. projekt. struct { int status string statusMessage array output ( )

Status (200=OK, 407=Neautorizovani pristup 500=Inzerat nenalezen) Slovni popis statusu.

}

listDevel( session_id as string ) as struct Výpis všech developerských projektů přihlášené realitní kanceláře.

V output je vráceno pole, kde každý prvek pole obsahuje developer_id, devel_rkid, advert_id (záznamy oddělené středníkem) a rkid (záznamy oddělené středníkem). struct { int status string statusMessage

Seznam.cz, a.s.

Status (200=OK, 407=Neplatne prihlaseni) Slovni popis statusu.

10.

Datum: 26.10.2005


}

array output ( int developer_id cislo devel. projektu string devel_rkid interni cislo realitky string advert_id prirazene inzeraty string rkid prirazene inzeraty )

addDevelPhoto( session_id as string, developer_id as int, devel_rkid as string, data as base64, main as int, alt as string, photo_rkid as string ) as struct Vložení fotografie k již uloženému deleveloperskému projektu.

Vstupními parametry jsou developer_id nebo devel_rkid, JPEG soubor zakódovaný pomocí base64, příznak, zda jde o hlavní či vedlejší fotografie (main = 1 – hlavní, main = 0 – vedlejší) a český popisek obrázku (alt). Pomocí developer_id nebo devel_rkid slouží k identifikaci. Vždy má přednost developer_id před devel_rkid (viz. odstavec 1.1). Výstupem je photo_id, které je vhodné si uložit pro mazání fotografie. Pokud je vkládána vedlejší fotografie, a přitom není u inzerátu žádná, stává se tato automaticky hlavní fotografií. Pokud je vkládána hlavní fotografie, a přitom u inzerátu již jedna je, stane se hlavní fotografie vedlejší a nová hlavní. Minimální rozlišení fotografie je 640x480 a maximální velikost souboru 100kB. Po překročení této velikosti server vrací chybu a fotografii nezpracuje. Fotografie jsou seřazeny podle pořadí vložení. struct { int status

}

string statusMessage array output ( int photo_id )

Status (200=OK, 407=Neplatne prihlaseni 500=Inzerat nenalezen, 471=Popisek k fotografii je povinny, 470=Neni to JPEG obrazek) Slovni popis statusu. cislo fotografie

delDevelPhoto( session_id as string, photo_id as int, photo_rkid as string ) as struct Vymazání fotografie.

Identifikací fotografie je photo_rkid nebo photo_id, které má přednost. Pokud je mazána hlavní fotografie, hlavní se automaticky stane první vedlejší. struct { int status string statusMessage array output ( )

Status (200=OK, 407=Neplatne prihlaseni 476=Fotografie nenalezena) Slovni popis statusu.

}

listDevelPhoto( session_id as string, developer_id as int, devel_rkid as string ) as struct Výpis fotografie existujícího developerského projektu.

V output je vráceno pole, kde každý prvek pole obsahuje photo_id, main (main = 1 – hlavní fotografie, main = 0 – vedlejší fotografie) a photo_rkid. struct

Seznam.cz, a.s.

11.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 {

}

int status string statusMessage array output ( int photo_id int main string photo_rkid )

Status (200=OK, 500=Inzerat nenalezen, 407=Neautorizovani pristup) Slovni popis statusu. cislo fotografie hlavni fotografie identifikace fotografie

statusAdvert( session_id as string, advert_id as array, rkid as array, user_status as int ) as struct Změna statusu inzerátů – aktivní / neaktivní.

Změna je závislá na vyplněných vstupních parametrech. Pokud je vyplněno pole advert_id, vezmou se jen uvedené inzeráty. Stejné je tomu i u rkid. Oba parametry se nedají kombinovat, vždy je třeba naplnit buď jeden nebo druhý. Při vyplnění advert_id se ignorují hodnoty v rkid, advert_id je preferováno (viz. odstavec 1.1). V případě, že není nenalezen ani jeden inzerát ze zadaných údajů, je vypsána chyba 500. Do statusu lze vložit jen hodnoty „aktivní“ (1) a „neaktivní“ (2). struct { int status

}


Status (200=OK, 407=Neplatne prihlaseni, 452=Spatne zadana data, 500=Inzerat nenalezen) Slovni popis statusu.

listStat( session_id as string, advert_id as array, rkid as array ) as struct Výpis statistiky inzerátu / inzerátů.

Výpis je závislý na vyplněných vstupních parametrech. Pro výpis statistiky všech inzerátů, je advert_id i rkid odesláno jako prázdné pole. Pokud je vyplněno pole advert_id, vypíší se jen uvedené inzeráty. Stejné je tomu i u rkid. Oba parametry se nedají kombinovat, vždy je třeba naplnit buď jeden nebo druhý. Při vyplnění advert_id se ignorují hodnoty v rkid, advert_id je preferováno (viz. odstavec 1.1). V output je vráceno pole, kde každý prvek pole obsahuje advert_id (číslo inzerátu), rkid (číslo inzerátu realitní kanceláře), yesterday_rate (včerejší návštěvnost), day_rate (denní návštěvnost), week_rate (týdenní návštěvnost), month_rate (měsíční návštěvnost) a total_rate (celková návštěvnost). struct { int status string statusMessage array output ( int advert_id string rkid int yesterday_rate int day_rate int week_rate int month_rate int total_rate )

Status (200=OK, 407=Neautorizovani pristup) Slovni popis statusu. cislo inzeratu cislo inzeratu realitni kancelare vcerejsi navstevnost denni navstevnost tydenni navstevnost mesicni navstevnost celkova navstevnost

}

version( ) as struct Výpis verze importu.

Seznam.cz, a.s.

12.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 struct { int status string statusMessage array output ( ) }

Seznam.cz, a.s.

Status (200=OK) Slovni popis statusu.

13.

Datum: 26.10.2005


 č Vysvětlivky: • string(x) – maximální počet znaků, delší řetězce se oříznou • int – číselná hodnota v rozmezí 0 – 2147483647 • text – retězec o maximální délce 65535 znaků • string[x] – pozice v řetězci , začínající od 0, s číselnou hodnotou 1 nebo 0, která vyjadřuje ano nebo ne (string[2] == 001) • tučně zvýrazněné položky jsou povinné

Inzerát Název

Hodnota

Popis 1 Prodej

advert_function

2 Pronájem 1 Zemědělské objekty

advert_type

2 Komerční objekty 3 Pozemky 4 Byty 5 Historické objekty 6 Domy a vily 7 Hotely, penziony a restaurace 8 Nájemní domy 9 Komerční prostory 10 Chaty a rekreační objekty 11 Malé objekty, garáže region_id

int

Viz. příloha region (při využití UIR-ADR je tento atribut ignorován)

advert_city

string(80)

Město (při využití UIR-ADR je tento atribut ignorován)

title

string(100)

Název inzerátu

title_en

string(100)

Název inzerátu v angličtině

basic_description

string(200)

Základní popis

basic_description_en

string(200)

Základní popis v angličtině

advert_price

int

Cena 1 CZK

advert_price_currency

2 USD 3 EUR 1 za nemovitost

advert_price_unit

2 za měsíc 3 za m2 4 za m2/měsíc 5 za m2/rok 6 za rok 7 za den

Seznam.cz, a.s.

14.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 Název

Hodnota

Popis

advert_lifetime

Atribut značí životnost inzerátu ve dnech. Po uplynutí této doby je inzerát automaticky deaktivován a následovně vymazán. Životnost je automaticky prodloužena, pokud se změní cena inzerátu. 7 životnost 7 dní 14 životnost 14 dní 30 životnost 30 dní 90 životnost 90 dní

user_status

Atribut značí, zda je inzerát aktivní (1) nebo neaktivní (2). Aktivní inzerát je zobrazen na webu a započítává se do placené inzerce. Neaktivní inzerát není zobrazen ani započítán do placené inzerce. 1 Status aktivní 2 Status neaktivní

uir

int

viz. UIR-ADR

uir_level

int

viz. UIR-ADR

advert_id

int

Číslo inzerátu pro editaci

rkid

string(100)

Interní číslo RK

seller_id

int

ID makléře

seller_rkid

string(30)

RKID makléře

advert_zip

int

PSČ (při dohledání v UIR-ADR s dostatečným uir_level je tento atribut přepsán)

developer_id

int

Číslo developerského projektu

devel_rkid

string(30)

RKID developerského projektu

advert_street

string(50)

Ulice (při dohledání v UIR-ADR s dostatečným uir_level je tento je tento atribut přepsán)

advert_co

int

Číslo orientační (při dohledání v UIR-ADR s dostatečným uir_level je tento je tento atribut přepsán)

advert_cp

int

Číslo popisné (při dohledání v UIR-ADR s dostatečným uir_level je tento je tento atribut přepsán)

advert_citypart

string(60)

Městská část (při dohledání v UIR-ADR s dostatečným uir_level je tento je tento atribut přepsán)

description

text

Detailní popis inzerátu

description_en

text

Detailní popis inzerátu v angličtině

show_map

0 Zobrazit na mapě 1 Nezobrazit na mapě

advert_price_note

string(100)

Poznámka k ceně

advert_price_note_en

string(100)

Poznámka k ceně v angličtině

makler_note

string(200)

Poznámka makléře

makler_note_en

string(200)

Poznámka makléře v angličtině

advert_url

string(100)

Virtuální prohlídka (bez http://)

extra_info

string[0]

Prodáno

string[1]

Rezervace

Seznam.cz, a.s.

15.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 Zemědělské objekty (1) Název

Hodnota

Popis

building_area

int

Zastavěná plocha

floors

int

Počet podlaží objektu

usable_area

int

Užitná plocha

plot_area

int

Plocha parcely

building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu

length

int

Délka

width

int

Šířka

height

int

Výška

underground_floors

int

Počet podlaží pod zemí

usable_area_ground

int

Užitná plocha v přízemí

usable_area_attic

int

Užitná plocha v podkroví

outer_communication_area

int

Plocha vnějších komunikací

balcony_area

int

Plocha balkonu

terrace_area

int

Plocha teras

other_area_description

string(200)

Jiné plochy (popis)

other_area

int

Jiné plochy

object_age

int

Stáří objektu

reconstruction_year

int

Rok rekonstrukce

acceptance_year

int

Rok kolaudace

equipment

0 Vybaveno - ne 1 Vybaveno - ano

equipment_description

text

Popis vybavení

equipment_description_en

text

Popis vybavení v angličtině

flats

int

Počet bytů - celkem

free_flats

int

Počet bytů - počet

workshop_area

int

Dílna (m2)

cellar_area

int

Plocha sklepu (m2)

nonresidential

string[0]

Další nebytové prostory - Garáž

string[1]

Dvojgaráž

string[2]

Přístřešek

object_location

int

viz. Umístění objektu

garden_area

int

Plocha zahrady (m2)

green_area

int

Další zelené plochy (m2)

green

0 Stromy - ne 1 Stromy - ano

road_type

int

viz. Komunikace

stairs

string(5)

viz. Schodiště

Seznam.cz, a.s.

16.

Datum: 26.10.2005


Hodnota

Popis

other

string[0]

Ostatní - Plot

string[1]

Bezbarierový přístup

string[2]

Bazén

string[3]

Garáž

string[4]

Výtah

string[5]

Parkoviště

string[6]

Ostraha

string[7]

Ostraha - PCO

string[8]

Recepce

string[9]

Vrátnice

string[10]

Stravování

string[11]

Sociální zařízení

ready_date

YYYY-MM-DD

K nastěhování

telecomunication

string(2)

viz. Telekomunikace

networks

string(4)

viz. Ostatní rozvody

heating

string(8)

viz. Topení

transport

string(5)

viz. Doprava

electricity

string(4)

viz. Elektřina

water

string(3)

viz. Voda

gully

string(2)

viz. Odpad

gas

string(2)

viz. Plyn

construction_elements

text

Konstrukční prvky

Název

Hodnota

Popis

total_area

int

Celková plocha (m2)

floor

int

Podlaží

parking

int

Počet míst k parkování

building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu

Komerční objekty (2)

0 Účel budovy

commercial_kind

1 Sklad 2 Výroba 3 Obchodní centrum 4 Nákupní středisko 5 Průmyslový areál 6 Jiný 7 Adminstrativní b. production_area

Seznam.cz, a.s.

int

Výrobní plocha (m2)

17.

Datum: 26.10.2005


Hodnota

Popis

operating_area

int

Provozní plocha (m2)

commercial_area_equipment

0 Vybavení komerčních prostor - ne 1 ano

com_area_equipment_description

string(200)

Vybavení komerčních prostor - popis

social

0 Sociální zařízení - ne 1 ano

social_description

string(200)

Sociální zarizeni - popis

building_area

int

Zastavěná plocha

floors

int


underground_floors

int


building_up_area

int

Obestavěný prostor

plot_area

int

Plocha parcely


int

Plocha vnějších komunikací

length

int

Délka

width

int

Šířka

height

int

Výška

shop_area

int

Obchodní plocha

store_area

int

Plocha skladů

reconstruction_year

int

Rok rekonstrukce

object_age

int

Stáří objektu

acceptance_year

int

Rok kolaudace

other

string[1]

Ostatní - Bezbarierový přístup

string[4]

Výtah

string[6]

Ostraha

string[7]

Ostraha - PCO

string[8]

Recepce

string[9]

Vrátnice

string[10]

Stravování

ready_date

YYYY-MM-DD

K nastěhování

object_location

int


telecomunication

string(2)

viz. Telekomunikace

networks

string(4)


heating

string(8)

viz. Topení

transport

string(5)

viz. Doprava

electricity

string(4)

viz. Elektřina

water

string(3)

viz. Voda

gully

string(2)

viz. Odpad

gas

string(2)

viz. Plyn

other_area

int

Jiné plochy (m2)

Seznam.cz, a.s.

18.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 Pozemky (3) Název

Hodnota

Popis

total_area

int

Celková plocha (m2) 1 Druh pozemku - pro komerční výstavbu

estate_kind

2 pro bydlení 3 zemědělská 4 les 5 trvalý travní porost 6 zahrada 7 ostatní 2 Jednotky plochy - m2

area_unit

3 ha building_area

int

Zastavěná plocha

engineering_networks

string[0]

Inženýrské sítě - vodovod

string[1]

Kanalizace

string[2]

Plyn

string[3]

Elektřina

surroundings_type

0 Charakter okolní zástavby - obytná 1 obchodní a obytná 2 obchodní 3 komerční 4 průmyslová 5 venkovská 6 rekreační 7 rekreačně nevyužitelná

object_location

int


road_type

int

viz. Komunikace

transport

string(5)

viz. Doprava

facilities

string(6)

viz. Občanská vybavenost

protection

string[0]

Umístění v chráněných lokalitách - ochranné pásmo

string[1]

národní park

string[2]

CHKO

estate_building_type

1 Druh stavby - budova/y, hala/y 2 inženýrské nebo specifické pozemní stavby 3 rodinný dům, rekreační chalupa, rekreační pozemek 4 rekreační a zahrádkářská chata 5 garáž 6 vedlejší stavba 7 studna 8 ostatní

Seznam.cz, a.s.

19.

Datum: 26.10.2005


Hodnota

Popis

other_facilities

string(200)

Ostatní vybavenost

estate_building

string[0]

Stavba na pozemku - Stavba na pozemku

string[1]

Cena stavby je zahrnuta v ceně pozemku

Hodnota

Popis

Byty (4) Název

1 Dispozice bytu (velikost) - garsoniéra

flat_kind

2 1+kk 3 2+kk 4 3+kk 5 4+kk 6 5+kk 7 6+kk 8 7+kk 9 1+1 10 2+1 11 3+1 12 4+1 13 5+1 14 6+1 15 7+1 16 atypický 17 jiný floor_number

int

Číslo podlaží v domě

floors

int


floor_area

int

Celková podlahová plocha (m2)

building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu

ownership (povinné pro prodej)

1 Vlastnictví - osobní 2 družstevní 3 jiný druh

rent_building_type

1 Druh bytu - byt v rodinném domě 2 v nájemním domě (činžovním) 3 v panelovém domě 4 v penzionu 5 jiný

underground_floors

int


estate_area

int

Vlastní pozemek (m2)

ceiling_height

int

Výška stropu (m)

Seznam.cz, a.s.

20.

Datum: 26.10.2005


Hodnota

Popis

balcony_area

int

Balkón (m2)

loggie_area

int

Lodžie (m2)

terrace_area

int

Terasy (m2)

cellar_area

int

Sklep (m2)

easy_access

0 Bezbariérový byt - ne 1 ano

garret

0 Pudní vestavba / nástavba - ne 1 ano

ready_date

YYYY-MM-DD

K nastěhování

flat_facilities

string[0]

Vybavení - garáž

string[1]

výtah

string[2]

parkoviště

object_location

int


telecomunication

string(2)

viz. Telekomunikace

networks

string(4)


equipment



text

Popis vybavení


text


heating

string(8)

viz. Topení

transport

string(5)

viz. Doprava

electricity

string(4)

viz. Elektřina

water

string(3)

viz. Voda

gully

string(2)

viz. Odpad

gas

string(2)

viz. Plyn

facilities

string(6)



text

Konstrukční prvky

reconstruction_year

int

Rok rekonstrukce

object_age

int

Stáří objektu

acceptance_year

int

Rok kolaudace

annuity

int

Anuita u prodeje

annuity_currency

1 CZK 2 USD 3 EUR

Historické objekty (5) Název

Hodnota

Popis

building_type

int

viz. Druh objektu

building_area

int

Zastavěná plocha (m2)

Seznam.cz, a.s.

21.

Datum: 26.10.2005


Hodnota

Popis

usable_area

int

Užitná plocha (m2)

floors

int


building_condition

int

viz. Stav objektu

plot_area

int

Plocha parcely (m2)

parking

int


object_kind

int

viz. Poloha objektu

length

int

Délka

width

int

Šířka

height

int

Výška

flats

int

Počet bytů celkem

free_flats

int

Počet bytů volných

balcony_area

int

Plocha balkonu (m2)

pool_area

int

Plocha bazénu

underground_floors

int


object_age

int

Stáří objektu

reconstruction_year

int

Rok rekonstrukce

equipment



string(200)

Popis vybavení


text


offices

int

Počet kanceláří

offices_area

int

Plocha kanceláří (m2)

workshop_premise_area

int

Dílny a provozovny (m2)

nolive_total_area

int

Celková plocha nebytových prostor (m2)

nolive_other_area

int

Další nebytové prostory (m2)

shops

int

Počet obchodů

shops_area

int

Plocha obchodů (m2)


int

Plocha vnějších komunikací (m2)

object_location

int


garden_area

int

Plocha zahrady (m2)

green_area

int


trees

string(200)

Stromy

road_type

int

viz. Komunikace

stairs

string(5)

viz. Schodiště

telecomunication

string(2)

viz. Telekomunikace

networks

string(4)


transport

string(5)

viz. Doprava

electricity

string(4)

viz. Elektřina

water

string(3)

viz. Voda

gully

string(2)

viz. Odpad

Seznam.cz, a.s.

22.

Datum: 26.10.2005


Hodnota

Popis


text

Konstrukční prvky

terrace_area

int

Plocha teras (m2)


string(200)

Jiné plochy

other

string[0]

Ostatní - Plot

string[4]

Výtah

string[6]

Ostraha

string[7]

Ostraha - PCO

string[9]

Vrátnice

string[11]


garage_area

int

Garáž (m2)

heating

string(8)

viz. Topení

gas

string(2)

viz. Plyn

ready_date

YYYY-MM-DD

K nastěhování

Název

Hodnota

Popis

object_kind

int

viz. Poloha objektu

usable_area

int


floors

int


Domy a vily (6)

1 Typ domu - přízemní

object_type

2 patrový building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu

building_area (povinné pro prodej)

int


plot_area (povinné pro prodej)

int

Plocha parcely (m2)

underground_floors

int


balcony_area

int

Plocha balkonu (m2)

terrace_area

int

Plocha teras (m2)


int


length

int

Délka

width

int

Šířka

height

int

Výška

reconstruction_year

int

Rok rekonstrukce

object_age

int

Stáří objektu

acceptance_year

int

Rok kolaudace

equipment



Seznam.cz, a.s.

string(200)

Popis vybavení

23.

Datum: 26.10.2005


Hodnota

Popis


text


workshop_area

int

Dílna (m2)

cellar_area

int

Sklep (m2)

flats

int

Počet bytů

flats_kind

string(100)

Velikost bytů (3+1, 2+kk atd.)

nonresidential

string[0]


string[1]

Dvojgaráž

string[2]

Přístřešek

object_location

int


garden_area

int

Plocha zahrady (m2)

green_area

int


green


road_type

int

viz. Komunikace

stairs

string(5)

viz. Schodiště

other

string[0]

Ostatní - Plot

string[1]


string[2]

Bazén

ready_date

YYYY-MM-DD

K nastěhování

telecomunication

string(2)

viz. Telekomunikace

networks

string(4)


heating

string(8)

viz. Topení

transport

string(5)

viz. Doprava

electricity

string(4)

viz. Elektřina

water

string(3)

viz. Voda

gully

string(2)

viz. Odpad

gas

string(2)

viz. Plyn

facilities

string(6)



text

Konstrukční prvky

usable_area_ground

int

Užitná plocha v přízemí (m2)

usable_area_attic

int

Užitná plocha v podkroví (m2)

other_facilities

string(200)

Ostatní vybavenost

other_area

int

Jiné plochy (m2)


string(200)

Jiné plochy - popis

Hotely, penziony a restaurace (7) Název

Hodnota

Popis Zastavěná plocha (m2)

building_area usable_area

Seznam.cz, a.s.

int


24.

Datum: 26.10.2005


Hodnota

Popis

plot_area

int

Plocha parcely (m2)

floors

int


building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu 1 Typ zařízení - Hotel

hotel_kind

2 Penzion 3 Restaurace object_kind

int

viz. Poloha objektu

usable_area_ground

int


usable_area_attic

int



int


balcony_area

int

Plocha balkonu (m2)

terrace_area

int

Plocha teras (m2)

underground_floors

int


other_area

int

Jiné plochy (m2)

width

int

Šířka

height

int

Výška

length

int

Délka

reconstruction_year

int

Rok rekonstrukce

object_age

int

Stáří objektu

acceptance_year

int

Rok kolaudace

ready_date

YYYY-MM-DD

K nastěhování

equipment



string(200)

Popis vybavení


text



int


garage_area

int

Garáž (m2)

shops

int

Počet obchodů

shops_area

int


nolive_total_area

int


nolive_other_area

int


nolive_other_description

string(200)

Popis ostatních nebyt. prostor

object_location

int


road_type

int

viz. Komunikace

seats

int

Počet míst

beds

int

Počet lůžek

Seznam.cz, a.s.

25.

Datum: 26.10.2005


Hodnota

Popis

other

string[0]

Ostatní - Plot

string[1]


string[4]

Výtah

string[5]

Parkoviště

string[6]

Ostraha

string[7]

Ostraha - PCO

string[8]

Recepce

garden_area

int

Plocha zahrady (m2)

green_area

int


green


telecomunication

string(2)

viz. Telekomunikace

networks

string(4)


heating

string(8)

viz. Topení

transport

string(5)

viz. Doprava

water

string(3)

viz. Voda

gully

string(2)

viz. Odpad

gas

string(2)

viz. Plyn

electricity

string(4)

viz. Elektřina


text

Konstrukční prvky

offices

int

Počet kanceláří

offices_area

int


free_offices

int

Počet volných kanceláří


string(200)


Název

Hodnota

Popis

building_area

int


usable_area

int


plot_area

int

Plocha parcely (m2)

floors

int


parking

int


building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu

balcony_area

int

Plocha balkonu (m2)

terrace_area

int

Plocha teras (m2)

object_kind

int

viz. Poloha objektu

underground_floors

int


other_area

int

Jiné plochy (m2)

Nájemní domy (8)

Seznam.cz, a.s.

26.

Datum: 26.10.2005


Hodnota

Popis

width

int

Šířka

height

int

Výška

length

int

Délka


int


usable_area_ground

int


usable_area_attic

int


reconstruction_year

int

Rok rekonstrukce

object_age

int

Stáří objektu

acceptance_year

int

Rok kolaudace

ready_date

YYYY-MM-DD

K nastěhování

equipment



string(200)

Popis vybavení


text



int


garage_area

int

Garáž (m2)

offices

int

Počet kanceláří

offices_area

int


nolive_other_area

int


shops

int

Počet obchodů

shops_area

int


nolive_total_area

int


flats

int

Počet bytů

free_flats

string(100)

Velikost bytů (3+1, 2+kk atd.)

object_location

int


road_type

int

viz. Komunikace

stairs

string(5)

viz. Schodiště

other

string[4]

Ostatní - Výtah

string[6]

Ostraha

string[7]

Ostraha - PCO

string[9]

Vrátnice

garden_area

int

Plocha zahrady (m2)

green_area

int


green


telecomunication

string(2)

viz. Telekomunikace

networks

string(4)


heating

string(8)

viz. Topení

transport

string(5)

viz. Doprava

water

string(3)

viz. Voda

Seznam.cz, a.s.

27.

Datum: 26.10.2005


Hodnota

Popis

gully

string(2)

viz. Odpad

gas

string(2)

viz. Plyn

electricity

string(4)

viz. Elektřina

facilities

string(6)


other_facilities

string(200)

Ostatní vybavenost


text

Konstrukční prvky


string(200)


Název

Hodnota

Popis

offices_area

int


building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu

Komerční prostory (9)

1 Druh prostor - Kanceláře

office_kind

2 Obchodní 3 Skladovací 4 Jiné 5 Výrobní parking

int


smallest_area

int

Plocha nejmenší (m2)

biggest_area

int

Plocha nejvetší (m2)

offices

int

Počet kanceláří

social

0 Sociální zarizeni - ne 1 ano

social_description

test

Sociální zarizeni - popis

sold_by_parts

0 Prodej v celku 1 Prodej po částech

width

int

Šířka

length

int

Délka

height

int

Výška

floors

int


underground_floors

int


building_area

int


usable_area

int


usable_area_ground

int


usable_area_attic

int


plot_area

int

Plocha parcely (m2)

balcony_area

int

Plocha balkonu (m2)

terrace_area

int

Plocha teras (m2)

Seznam.cz, a.s.

28.

Datum: 26.10.2005


Hodnota

Popis

other_area

int

Jiné plochy (m2)


string(200)



int


object_age

int

Stáří objektu

reconstruction_year

int

Rok rekonstrukce

acceptance_year

int

Rok kolaudace

equipment



string(200)

Popis vybavení


text


workshop_area

int

Dílna (m2)

store_area

int

Plocha skladů

nonresidential

string[0]


string[1]

Dvojgaráž

string[2]

Přístřešek

office_equipment

0 Vybavení kanceláří - ne 1 ano

office_equipment_description

text

Vybavení kanceláří - popis

object_location

int


road_type

int

viz. Komunikace

stairs

string(5)

viz. Schodiště

other

string[0]

Ostatní - Plot

string[1]


string[2]

Bazén

string[3]

Garáž

string[4]

Výtah

string[5]

Parkoviště

string[6]

Ostraha

string[7]

Ostraha - PCO

string[8]

Recepce

string[9]

Vrátnice

string[10]

Stravování

string[11]


ready_date

YYYY-MM-DD

K nastěhování

telecomunication

string(2)

viz. Telekomunikace

networks

string(4)


heating

string(8)

viz. Topení

transport

string(5)

viz. Doprava

electricity

string(4)

viz. Elektřina

water

string(3)

viz. Voda

Seznam.cz, a.s.

29.

Datum: 26.10.2005


Hodnota

Popis

gully

string(2)

viz. Odpad

gas

string(2)

viz. Plyn


text

Konstrukční prvky

Název

Hodnota

Popis

object_kind

int

viz. Poloha objektu

building_area

int


usable_area

int


floors

int


plot_area

int

Plocha parcely (m2)

building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu

object_location

int


balcony_area

int

Plocha balkonu (m2)

terrace_area

int

Plocha teras (m2)

underground_floors

int



int


length

int

Délka

width

int

Šířka

height

int

Výška

usable_area_ground

int


usable_area_attic

int


reconstruction_year

int

Rok rekonstrukce

object_age

int

Stáří objektu

acceptance_year

int

Rok kolaudace

Chaty a rekreační objekty (10)

equipment



string(200)

Popis vybavení


text


workshop_area

int

Dílna (m2)

cellar_area

int

Sklep (m2)

nonresidential

string[0]


string[1]

Dvojgaráž

string[2]

Přístřešek

garden_area

int

Plocha zahrady (m2)

green_area

int


green


Seznam.cz, a.s.

30.

Datum: 26.10.2005


Hodnota

Popis

road_type

int

viz. Komunikace

stairs

string(5)

viz. Schodiště

other

string[0]

Ostatní - Plot

string[1]


string[2]

Bazén

ready_date

YYYY-MM-DD

K nastěhování

telecomunication

string(2)

viz. Telekomunikace

networks

string(4)


heating

string(8)

viz. Topení

transport

string(5)

viz. Doprava

electricity

string(4)

viz. Elektřina

water

string(3)

viz. Voda

gully

string(2)

viz. Odpad

gas

string(2)

viz. Plyn

facilities

string(6)



text

Konstrukční prvky

disposition

1 Dispozice bytu (velikost) - garsoniéra 2 1+kk 3 2+kk 4 3+kk 5 4+kk 6 5+kk 7 6+kk 8 7+kk 9 1+1 10 2+1 11 3+1 12 4+1 13 5+1 14 6+1 15 7+1 16 atypický 17 jiný

other_facilities

string(200)

Ostatní vybavenost

other_area

int

Jiné plochy (m2)


string(200)


Hodnota

Popis

Malé objekty, garáže (11) Název

Seznam.cz, a.s.

31.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 object_kind

int

viz. Poloha objektu

building_area

int


building_type

int

viz. Druh objektu

building_condition

int

viz. Stav objektu

width

int

Šířka

length

int

Délka

height

int

Výška

object_location

int


road_type

int

viz. Komunikace

electricity

string(4)

viz. Elektřina


string(200)


object_age

int

Stáří objektu

reconstruction_year

int

Rok rekonstrukce

acceptance_year

int

Rok kolaudace

Developerské projekty (developer) Název

Hodnota

Popis

region_id

int

Viz. příloha region

project_name

string(100)

Název

project_city

string(80)

Město

project_zip

int

PSČ

developer_name

string(60)

Název společnosti

developer_street

string(60)

Ulice

developer_city

string(40)

Město

developer_zip

int

PSČ

developer_email

string(80)

E-mail

developer_phone

string(15)

Telefon

locality_description

text

Popis lokality

basic_project_description

string(200)

Základní popis

beginning_date

YYYY-MM-DD

Datum zahájení stavby

ready_date

YYYY-MM-DD

K nastěhování

finish_date

YYYY-MM-DD

Datum ukončení stavby

sale_date

YYYY-MM-DD

Datum zahájení prodeje

user_status

0 Status neaktivní 1 Status aktivní

devel_rkid

string(30)

Číslo develop. proj. podle číslování realitky

developer_id

int

Číslo developerského projektu

project_street

string(50)

Ulice kde se dp realizuje

investor_name

string(60)

Název investora

investor_street

string(60)

Ulice - adresa investora

investor_city

string(40)

Město - adresa investora

Seznam.cz, a.s.

32.

Datum: 26.10.2005


Hodnota

Popis

investor_zip

int

PSČ - adresa investora

investor_email

string(80)

Email investora

investor_phone

string(15)

Telefon investora

investor_fax

string(15)

Fax investora

investor_www

string(40)

Internetové stránky investora

investor_country

string(40)

Země - adresa investora

developer_www

string(40)

Internetové stránky developera

developer_fax

string(15)

Fax developera

developer_country

string(40)

Země - adresa developera

project_description

text

Kompletní popis dp

steps

text

Počet a popis etap projektu

basic_deposit

int

Základní vklad

mortgage

0 Hypotéka - ne 1 ano

mortgage_institute

string(80)

Hypoteční ústav

mortgage_percent

float

Hypotéka - procenta

spor_percent

float

Stavební spoření - procenta

personal

0 Možnost převedení do osobního vlastnictví - ne 1 ano

object_count

int

Počet objektů v projektu

flat_count

int

Byty - počet

smallest_flat_area

int

Byty - plocha nejmenšího bytu v m2

largest_flat_area

int

Byty - plocha největšího bytu v m2

min_flat_price

int

Byty - minimální cena bytu

max_flat_price

int

Byty - maximální cena bytu

office_count

int

Kanceláře - počet

smallest_office_area

int

Kanceláře - plocha nejmenší kanceláře

largest_office_area

int

Kanceláře - plocha největší kanceláře

min_office_price

int

Kanceláře - minimální cena kanceláře

max_office_price

int

Kanceláře - maximální cena kanceláře

house_count

int

Domy - počet

min_house_volume

int

Domy - nejmenší obestavěný prostor

max_house_volume

int

Domy - největší obestavěný prostor

min_house_price

int

Domy - minimální cena domu

max_house_price

int

Domy - maximální cena domu

commercial_count

int

Komerční plochy - počet

min_commercial_area

int

Komerční plochy - plocha nejmenší

max_commercial_area

int

Komerční plochy - plocha největší

other_areas

text

Ostatní plochy

garages

0 Zda jsou v objektech v dp garáže - ne 1 ano

parking_place_count

int

Počet parkovacích míst

zaklady

string(100)

Popis - základy

Seznam.cz, a.s.

33.

Datum: 26.10.2005


Hodnota

Popis

stropy

string(100)

Popis - stropy

strecha

string(100)

Popis - střecha

krytina

string(100)

Popis - krytina

klempirina

string(100)

Popis - klempířská konst

vnitrni_omitky

string(100)

Popis - vnitřní omítky

fasadni_omitky

string(100)

Popis - fasádní omítky

vnejsi_obklady

string(100)

Popis - vnější obklady

vnitrni_obklady

string(100)

Popis - vnitřní obklady

schody

string(100)

Popis - schody

dvere

string(100)

Popis - dveře

okna

string(100)

Popis - okna

podlahy

string(100)

Popis - podlahy

kitchen_table

0 Zda je v ceně kuchyňská linka - ne 1 ano

telecomunication

string(20)

viz. Telekomunikace

networks

string(20)


heating

string(20)

viz. Topení

transport

string(20)

viz. Doprava

electricity

string(20)

viz. Elektřina

water

string(20)

viz. Voda

gully

string(20)

viz. Odpad

gas

string(20)

viz. Plyn

facilities

string(20)


Společné konstanty Poloha objektu (object_kind)

1 řadový 2 rohový 3 v bloku 4 samostatný

Schodiště (stairs)

string[0]

Zábradlí - dřevěné

string[1]

Zábradlí - kamenné

string[2]

Zábradlí - betonové

string[3]

Zábradlí - ocelové

string[4]

Zábradlí - zábradlí - madlo 1 betonová

Komunikace (road_type)

2 dlážděná 3 asfaltová 4 neupravená

Seznam.cz, a.s.

34.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 1 dřevěná

Druh Objektu (building_type)

2 cihlová 3 kamenná 4 montovaná 5 panelová 6 skeletová 7 smíšená 1 velmi dobrý

Stav objektu (building_condition)

2 dobrý 3 špatný 4 ve výstavbě (hrubá stavba) 5 projekt 6 novostavba 7 určený k demolici 8 před rekonstrukcí 9 po rekonstrukci 1 centrum obce

Umístění objektu (object_location)

2 klidná část obce 3 rušná část obce 4 okraj obce 5 sídliště 6 polosamota 7 samota

Telekomunikace (telecomunication)

string[0]

Telefon

string[1]

Internet

Ostatní rozvody (networks)

string[0]

Satelit

string[1]

Kabelová televize

string[2]

Kabelové rozvody

string[3]

Ostatní rozvody

Seznam.cz, a.s.

35.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 string[0]

Lokální - plynové

string[1]

Lokální - tuhá paliva

string[2]

Lokální - elektrické

string[3]

Ústřední - plynové

string[4]

Ústřední - tuhá paliva

string[5]

Ústřední - elektrické

string[6]

Ústřední - dálkové

string[7]

Jiné

string[0]

vlak

string[1]

dálnice

string[2]

silnice

string[3]

MHD

string[4]

autobus

string[0]

Elektro - 120 V

string[1]

Elektro - 230 V

string[2]

Elektro - 380 V

string[3]

Elektro - 400 V

string[0]

Voda - zdroj pro celý objekt

string[1]

Voda - dálkový vodovod

string[2]

Voda - rozvod studené a teplé vody

Odpad (gully)

string[0]

Kanalizace

string[1]

ČOV pro celý objekt

Plyn (gas)

string[0]

Individuální

string[1]

Plynovod

Občanská vybavenost (facilities)

string[0]

Škola

string[1]

Školka

string[2]

Zdravotnická zařízení

string[3]

Pošta

string[4]

Supermarket

string[5]

Kompletní síť obchodů a služeb

Topení (heating)

Doprava (transport)

Elektřina (electricity)

Voda (water)

Adresy, UIR-ADR Adresy je nutno specifikovat na město (případně městskou část), byty až na číslo popisné nebo číslo orientační. Odpovídající uir_level naleznete v tabulce níže. Ministerstvo práce a sociálních věcí ve spolupráci s obecními úřady udržuje registr adres všech Seznam.cz, a.s.

36.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 stavebních objektů, které mají číslo domovní. Česká pošta poskytuje pro adresy platná poštovní směrovací čísla. Ministerstvo práce a sociálních věcí dává tento registr k dispozici veřejnosti. Kromě zpřístupnění dat registru na www stránkách MPSV (http://forms.mpsv.cz/uir/) je možno získat zdarma CD-ROM s daty a programy pro prohlížení a periodickou aktualizaci těchto dat. Při použití UIR kódu není nutno vyplňovat adresu, kromě případu, kdy UIR kód není dostatečně podrobný, pak je možno adresu upřesnit textově. (Příklad: K bytu máme k dispozici UIR kód na úrovni 5, je tedy potřeba doplnit položky advert_street, advert_cp. V případě, že bychom doplnili i advert_city, nebude bráno v potaz a naopak bude přepsáno hodnotou z UIR) Pro potřebu Srealit je využita jen část této rozsáhlé databáze. Název (uir_level)

Popis

Okres (1)

Číselník obsahuje veškeré okresy.

Obec (3)

Číselník obsahuje všechny obce. Z obce lze zjistit k jakému okresu patří.

Část obce (5)

Číselník obsahuje všechny části obce. Některé obce jsou jen částí hlavní obce. Zpětně lze dohledat obci a okres.

Ulice (7)

Číselník obsahuje všechny ulice. Zpětně lze dohledat obci a okres.

Objekt (9)

V číselníku je uvedena část obce, číslo popisné a případná městská část. Zpětně lze dohledat část obce a okres.

Adresa (11)

Z UIR-ADR adresy lze kompletně dohledat celou adresu, tj. okres, obec, část obce, městskou část, číslo popisné, číslo orientační a PSČ.

Městská část (17) Obsahuje všechny městské části. Zpětně lze dohledat obec a okres.

Povinnost minimálního uir_level je závislá na druhu nemovitosti. Název druhu

Minimální uir_level

Zemědělské objekty (1)

Obec (3) a u měst s městskými částmi Městská část (17)

Komerční objekty (2)


Pozemky (3)


Byty (4)

Adresa (11)

Historické objekty (5)


Domy a vily (6)


Hotely, penziony a restaurace (7)


Nájemní domy (8)


Komerční prostory (9)


Chaty a rekreační objekty (10)


Malé objekty, garáže (11)


Regiony UIR (region_id) Název regionu 3201 Benešov 3202 Beroun 3701 Blansko 3702 Brno-město 3703 Brno-venkov 3801 Bruntál

Seznam.cz, a.s.

37.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 UIR (region_id) Název regionu 3704 Břeclav 3402 Cheb 3503 Chomutov 3603 Chrudim 3502 Děčín 3401 Domažlice 3501 Česká Lípa 3301 České Budějovice 3302 Český Krumlov 3802 Frýdek-Místek 3601 Havlíčkův Brod 3706 Hodonín 3602 Hradec Králové 3504 Jablonec nad Nisou 3811 Jeseník 3604 Jičín 3707 Jihlava 3303 Jindřichův Hradec 3403 Karlovy Vary 3803 Karviná 3203 Kladno 3404 Klatovy 3204 Kolín 3708 Kroměříž 3205 Kutná Hora 3505 Liberec 3506 Litoměřice 3507 Louny 3206 Mělník 3207 Mladá Boleslav 3508 Most 3605 Náchod 3804 Nový Jičín 3208 Nymburk 3805 Olomouc 3806 Opava 3807 Ostrava-město 3606 Pardubice 3304 Pelhřimov 3305 Písek

Seznam.cz, a.s.

38.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 UIR (region_id) Název regionu 3406 Plzeň-jih 3405 Plzeň-město 3407 Plzeň-sever 3306 Prachatice 500054 Praha 1 500224 Praha 10 547034 Praha 11 547107 Praha 12 539694 Praha 13 547361 Praha 14 547387 Praha 15 539601 Praha 16 547174 Praha 17 547417 Praha 18 547344 Praha 19 500089 Praha 2 538213 Praha 20 538949 Praha 21 538931 Praha 22 500097 Praha 3 500119 Praha 4 500143 Praha 5 500178 Praha 6 500186 Praha 7 500208 Praha 8 500216 Praha 9 538078 Praha-Benice 538060 Praha-Běchovice 538124 Praha-Březiněves 547301 Praha-Dolní Chabry 547379 Praha-Dolní Měcholupy 538175 Praha-Dolní Počernice 538205 Praha-Dubeč 547310 Praha-Čakovice 547298 Praha-Ďáblice 538302 Praha-Klánovice 538353 Praha-Koloděje 538361 Praha-Kolovraty 538388 Praha-Královice 547042 Praha-Kunratice

Seznam.cz, a.s.

39.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 UIR (region_id) Název regionu 538400 Praha-Křeslice 547051 Praha-Libuš 539449 Praha-Lipence 539465 Praha-Lochkov 547140 Praha-Lysolaje 547158 Praha-Nebušice 538531 Praha-Nedvězí 547395 Praha-Petrovice 539589 Praha-Přední Kopanina 538736 Praha-Satalice 539678 Praha-Slivenec 547271 Praha-Suchdol 547328 Praha-Troja 539791 Praha-Újezd 547115 Praha-Velká Chuchle 539007 Praha-Vinoř 3209 Praha-východ 3210 Praha-západ 539864 Praha-Zbraslav 539899 Praha-Zličín 539724 Praha-Šeberov 547409 Praha-Štěrboholy 539635 Praha-Řeporyje 3709 Prostějov 3808 Přerov 3211 Příbram 3212 Rakovník 3408 Rokycany 3607 Rychnov nad Kněžnou 3608 Semily 3409 Sokolov 3307 Strakonice 3609 Svitavy 3308 Tábor 3410 Tachov 3509 Teplice 3610 Trutnov 3710 Třebíč 3711 Uherské Hradiště 3510 Ústí nad Labem

Seznam.cz, a.s.

40.

Datum: 26.10.2005

Sreality - XML-RPC IMPORT v1.0 UIR (region_id) Název regionu 3611 Ústí nad Orlicí 3810 Vsetín 3712 Vyškov 3705 Zlín 3713 Znojmo 3809 Šumperk 3714 Žďár nad Sázavou

Error hlášky Status

Status message 200 OK 210 Odhlášení proběhlo v pořádku 301 Překročena maximální velikost dat. 401 Přihlašovací jméno neodpovídá struktuře databáze Seznam Reality. Jméno musí být číslo. 402 V databázi Seznam Reality není vedena žádná registrace s tímto přihlašovacím jménem. 403 Přihlašovací heslo nesouhlasí. 405 Neplatný klíč softwaru. 407 Neplatné přihlášení. 410 Vaše společnost není aktuálně vedena jako platící. 412 Nemáte oprávnění vkládat inzerci přes toto rozhraní. 450 Neplatná struktura parametrů metody. 452 Nejsou vyplněny všechny povinné položky nebo jsou špatného typu (%s). 453 Nejsou vyplněny všechny povinné položky druhu nebo jsou špatného typu (%s). 455 Neplatný kód UIR-ADR. 457 Adresa pro tento druh není kompletní (%s). 460 ID makléře je již použito. 461 ID makléře neexistuje. 470 Neznámý typ obrázku. Používejte obrázky typu JPG. 471 Popisek k fotografii je povinný. 475 Fotografii nebylo možné odstranit. 476 Fotografie neexistuje. 480 Chyba při zápisu nabídky do databáze. 500 Inzerát pro tuto RK neexistuje! 701 Inzerát je v tisku, nyní nelze smazat. 703 Inzerát je již v tisku. 705 Inzerát není v tisku. 707 Inzerát nemá hlavní fotku, nelze vložit do tisku.

Seznam.cz, a.s.

41.

Datum: 26.10.2005


 ř PEAR send($msg); // nacteni vysledku $getHash = XML_RPC_decode($response->value()); // je dotaz je OK ? if ($getHash['status'] == 200) { // prekopirovani outputu do zvlast promenne $output = $getHash['output']; // vytvoreni dotazu pro login a poslani na server $params = array(new XML_RPC_Value($output[0]), new XML_RPC_Value(md5(md5('xxx').$output[1])), new XML_RPC_Value('xxx')); $msg = new XML_RPC_Message("login", $params); $response = $client->send($msg); // nacteni vysledku $login = XML_RPC_decode($response->value()); // pokud je status 200, je to OK if ($login['status'] != 200) { echo "Chyba [$login[status]]: $login[statusMessage]\n"; } } else { echo "Chyba [$getHash[status]]: $getHash[statusMessage]\n"; } ?>

Seznam.cz, a.s.

42.

Datum: 26.10.2005

SeznamReality Import XML-RPC server

Recommend Documents