Dokumentace importu

Obsah nabídek patří kanceláři, která je posílá se souhlasem klientů. Nabídky se zobrazují pod jejím účtem.

Přístup

Založte si účet s rolí Realitní kancelář.
Požádejte o přístup – token pro feed API nebo údaje pro RPC2 vám předáme jednorázově.
Každý požadavek feed API nese hlavičku Authorization: Bearer <token>. Limit 120 požadavků za minutu.

JSON feed API v1

Metoda	Cesta	Co dělá
POST	`/api/feed/v1/listings`	Vloží nebo aktualizuje 1–200 nabídek podle `external_id`
GET	`/api/feed/v1/listings`	Stav nabídek kanceláře (pending, active, rejected s důvodem, expired)
DELETE	`/api/feed/v1/listings/{external_id}`	Stáhne nabídku z webu

Položka nabídky

Volitelné: title, disposition, area_m2, fees_czk, deposit_czk, district, street, lat, lng, furnishing, floor, has_elevator, has_balcony, has_parking, pets_allowed, available_from (YYYY-MM-DD), photos (až 20 adres https:// v pořadí zobrazení).

{"listings": [{"external_id": "RK-1042", "offer_type": "rent", "property_type": "flat",
  "disposition": "2+kk", "area_m2": 54, "price_czk": 24000, "city": "Praha", "penb": "C",
  "description": "Světlý byt po rekonstrukci, 3 minuty od metra."}]}

Fotky se stahují na pozadí; přijímáme JPEG/PNG/WebP z veřejných HTTPS adres bez přesměrování.

XML-RPC import (RPC2)

Adresa https://onreality.cz/import/RPC2, protokol XML-RPC, UTF-8, POST, max. 2 MB na požadavek. Pro výrobce CRM, kteří už mají XML-RPC konektor pro realitní inzerci: stačí změnit adresu a přihlašovací údaje.

getHash(client_id) vrátí sessionId.
Před každým voláním klient spočítá nové session_id z předchozího, hesla a software_key.
login, volání (addAdvert, delAdvert, listAdvert), na konci logout. Relace vyprší po 15 minutách nečinnosti.

Nepodporované metody (videa, statistiky, poptávky aj.) vracejí stav 501. Přesný popis mapování položek vám pošleme spolu s přístupem.