API pro import inzerátů

Rozhraní pro realitní kanceláře a výrobce realitního softwaru, kteří chtějí inzeráty na RocketReality vkládat a aktualizovat automaticky. Import funguje jako jednoduché REST API — jeden HTTP požadavek na inzerát, formát JSON.

Získání API klíče

API klíč vydáváme na vyžádání. Napište nám na obchod@rocketreality.cz — uveďte název realitní kanceláře nebo softwaru a přibližný počet inzerátů. Klíč je vázaný na vaši kancelář a lze ho kdykoli deaktivovat.

Endpoint

POST https://rocketnemovitosti.cz/api/import/inzeraty
Authorization: Bearer {váš API klíč}
Content-Type: application/json

Každý požadavek odešle jeden inzerát. Opakované odeslání se stejným externalId stávající inzerát aktualizuje — duplicity nevznikají.

Pole požadavku

Pole	Typ	Povinné	Popis
externalId	string	ano	Stálý identifikátor inzerátu ve vašem systému. Opakované odeslání se stejným externalId inzerát aktualizuje, nevytvoří duplicitu.
title	string	ano	Titulek inzerátu.
sourceUrl	string (URL)	ne	Odkaz na inzerát ve zdrojovém systému.
description	string \| null	ne	Popis nemovitosti v prostém textu.
offerType	"sale" \| "rent" \| "other"	ano	Typ nabídky — prodej, pronájem, jiné.
propertyType	string \| null	ne	Druh nemovitosti, např. "apartment", "house", "land", "commercial".
price	number \| null	ne	Cena v Kč. Null znamená cenu na vyžádání.
priceNote	string	ne	Poznámka k ceně, např. "k jednání" nebo "včetně provize".
currency	"CZK"	ano	Měna ceny. Aktuálně podporujeme pouze CZK.
size	number	ne	Užitná plocha v m².
location	objekt	ano	Adresa nemovitosti: street, city, postalCode, region.
photos	pole objektů	ano	Fotografie jako { url, alt }. Adresy musí být veřejně dostupné — portál si fotografie stáhne při zpracování.
agent	objekt \| null	ne	Kontakt na makléře: name, email, phone. Zobrazí se u inzerátu.

Příklad požadavku

curl -X POST https://rocketnemovitosti.cz/api/import/inzeraty \
  -H "Authorization: Bearer VAS_API_KLIC" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "rk-1024",
    "sourceUrl": "https://www.vase-rk.cz/nemovitosti/rodinny-dum-opava",
    "title": "Rodinný dům 5+kk se zahradou, Opava",
    "description": "Prostorný dům s garáží a udržovanou zahradou…",
    "offerType": "sale",
    "propertyType": "house",
    "price": 8900000,
    "priceNote": "k jednání",
    "currency": "CZK",
    "size": 145,
    "location": {
      "street": "Javorová 18",
      "city": "Opava",
      "postalCode": "74601",
      "region": "moravskoslezsky"
    },
    "photos": [
      { "url": "https://www.vase-rk.cz/foto/dum-1.jpg", "alt": "Pohled na dům" }
    ],
    "agent": {
      "name": "Jan Novák",
      "email": "jan.novak@vase-rk.cz",
      "phone": "+420 777 123 456"
    }
  }'

Odpovědi

Stav	Význam
200	Inzerát byl přijat ke zpracování (vytvoření nebo aktualizace).
401	Chybějící nebo neplatný API klíč.
422	Tělo požadavku neprošlo validací — odpověď obsahuje popis chyb.
429	Příliš mnoho požadavků — zkuste to znovu později.
5xx	Chyba na naší straně — požadavek bezpečně zopakujte.

Moderace a zveřejnění

Importované inzeráty procházejí stejnou moderací jako inzeráty vložené ručně. Po schválení se zveřejní; aktualizace již schválených inzerátů se propisují automaticky. Za obsah inzerátů odpovídá inzerující kancelář — viz podmínky užití.