Popis exportního/importního rozhraní na sidlorealit.cz

Pro minimalizaci pracnosti na straně exportéra je importní rozhraní definováno dle standardu trhu:

Podporované funkce

  • getHash(), login(), logout()
  • addAdvert(), delAdvert(), topAdvert(), listAdvert()
  • addPhoto(), delPhoto(), listPhoto()
  • addSeller(), delSeller(), listSeller()

Exportní rozhraní

Pro export lze využít REST API nebo XML-RPC rozhraní, server zpracováná požadavky volány metodou POST s UTF-8 kódováním. Jestli-že chcete exportovat na portál sidlorealit.cz, obraťte se s požadavkem na podpora@sidlorealit.cz, kde Vám založí účet s zpřístupní testovací prostředí.

REST API
- Rozhraní se nachází na adrese https://sidlorealit.cz/api/import

XML-RPC
- Rozhraní se nachází na adrese https://sidlorealit.cz/api/import/xmlrpc

Průběh komunikace

  • getHash(client_id)
  • login(session_id)
  • listSeller(session_id)
  • ...
  • addAdvert(session_id, advert_id, advert_rkid, data)
  • addPhoto(session_id, advert_id, advert_rkid, data)
  • ...
  • logout(session_id)

Názvosloví

  • client_id - unikátní interní označení pro realitní kancelář (účet)
  • session_id - unikátní označení pro časově označenou relaci (přístup na importní rozhraní)
  • password - heslo realitní kanceláře (účtu) potřebné pro přístup k importnímu rozhraní (lze nastavit v administraci)
  • software_key - konstanta přidělená pro každý exportní software
  • advert_id - unikátní interní označení inzerátu
  • photo_id - unikátní interní označení fotky
  • photo_id - unikátní interní označení makléře
  • rkid - unikátní označení v rámci realitní kanceláře (účtu)