Realsoft feed

Kancelária, ktorej softvér vie Realsoft export, nemusí nič programovať: NAJDO si export sťahuje sám. Ak váš softvér posiela zmeny, použite radšej Import API.

Formát

  • JSON OfficeData[] podľa dokumentácie United Classifieds: pobočky (office), v nich makléri (user_data[].user) a ich inzeráty (advertisements[]) s číselníkmi UC.
  • Export je dostupný cez HTTPS na stálej adrese s prístupovým tokenom, napr. https://www.vasa-kancelaria.sk/realestate/export/realsoft?t=….
  • Export obsahuje celú aktuálnu ponuku kancelárie. Inzerát, ktorý v ňom chýba, portál archivuje. Export bez jediného inzerátu portál berie ako rozbitý a nearchivuje nič.
  • Najviac 64 MB a 120 s na stiahnutie. Väčšiu sieť rozdeľte na viac exportov (parameter feed=).

Identita kancelárie

Kanceláriu určuje host adresy exportu bez www. (napr. vasa-kancelaria.sk). Pod ním sa vedú jej pobočky, makléri aj inzeráty. Agregátor, ktorý na jednom hoste vystavuje viac exportov, ich rozlíši parametrom ?feed=. Výmena tokenu je bez problému; adresa, ktorá ukazuje na iný host alebo iný feed, sa musí dohodnúť vopred, lebo presúva celú ponuku.

Čo portál znesie

  • Súradnice ako reťazce ("48.14").
  • 0 alebo chýbajúce county_id, district_id, region_id, street_id; berú sa ako neznáme.
  • Chýbajúce podmienené parametre (byt bez poschodia alebo počtu izieb, dom či pozemok bez plochy pozemku). Inzerát sa uloží s upozornením, ktoré kancelária uvidí v histórii importov.
  • Chybný inzerát sa preskočí a zapíše; ostatné sa importujú.

Fotky

Fotky sú URL v images[], prvá je hlavná. Portál ich stiahne, otočí podľa EXIF, zmenší na najviac 2560 px a uloží bez EXIF a GPS. Fotka nad 10 MB alebo iný súbor ako obrázok sa preskočí. Nezmenená fotka sa nesťahuje znova.

Interval

Predvolene každých 6 hodín, nastaviteľne od 30 minút do 7 dní. Import beží v noci aj cez deň.

Ako sa pripojiť

Pošlite adresu exportu na info@najdo.sk. Prvý import trvá dlhšie, lebo sa sťahujú všetky fotky; ďalšie prenášajú len zmeny.