Pro realitní kanceláře: přímý import
Realitka může posílat inzeráty přímo. Rozhraní vychází z formátu importu Sreality (XML-RPC, stejné názvy metod a polí), takže realitní software, který už inzeruje na Sreality, stačí přesměrovat na novou adresu.
Adresa rozhraní
POST https://bydlonos.cz/api/reality/import (Content-Type: text/xml)
Přístup (client_id, heslo a softwarový klíč) přiděluje správce aplikace.
Přihlášení
getHash(client_id)→ vrátíoutput[0].sessionId(80 znaků).- Prvních 48 znaků ponechte, posledních 32 nahraďte
md5(md5(heslo) + prvních48 + softwarový_klíč). login(session_id)→ status 200. Session platí hodinu od posledního volání.
Metody
| Metoda | Parametry | Co dělá |
|---|---|---|
addAdvert | session_id, advert_data (struct) | Vloží nebo aktualizuje inzerát (klíč je vaše advert_rkid). Vrátí advert_id. |
delAdvert | session_id, advert_id, advert_rkid | Stáhne inzerát. |
listAdvert | session_id | Seznam vašich aktivních inzerátů. |
addPhoto | session_id, advert_id, advert_rkid, data (struct: data base64, order, alt) | Fotka JPEG/PNG/WebP do 3 MB, nejvýš 40 na inzerát. |
logout | session_id | Ukončí session. |
Pole advert_data
| Pole | Význam |
|---|---|
advert_rkid | Vaše ID inzerátu (povinné) |
advert_function | 1 prodej, 2 pronájem, 3 dražba |
advert_type | 1 byt, 2 dům, 3 pozemek, 4 komerční, 5 ostatní |
advert_subtype | Podtyp podle číselníku Sreality (u bytů dispozice: 2 = 1+kk, 3 = 1+1, 4 = 2+kk, 5 = 2+1, 6 = 3+kk …) |
advert_price | Cena v Kč (u pronájmu měsíčně) |
usable_area, estate_area | Užitná plocha, plocha pozemku (m²) |
description, advert_title | Popis, vlastní titulek (nepovinný) |
locality_city, locality_citypart, locality_street, locality_district, locality_region | Adresa |
locality_latitude, locality_longitude | GPS |
building_type, building_condition, ownership, floor_number, energy_efficiency_rating … | Parametry (zobrazí se v detailu) |
advert_url, seller_name | Odkaz na váš web, jméno makléře |
Odpověď má vždy tvar { status, statusMessage, output }; status 200 = v pořádku.