Přeskočit obsah
P
API pro partnery
Napojení vlastní aplikace — přístup, autentizace a endpointy
Reference endpointů / Katalog firem

Comcat — katalog firem#

Modul vznikl z inzerce, takže vzory jsou téměř totožné.

Každý zdroj nabízí standardní sadu akcí

get, get-by, get-all, save, update-columns, delete, delete-all — není-li u něj uvedeno jinak. Podrobně CRUD vzor.

Zdroje#

Zdroj Poznámka
advert firemní profil — vlastník, událost
advert-report nahlášení
advert-statistics statistiky
category obor — strom, veřejné
parameter parametr — strom, veřejné
parameter-group skupina parametrů
parameter-rule pravidlo zobrazení
category-parameter-rel cílení parametru na obor
response odpověď — vlastník, příjemce
watchdog hlídač — vlastník
tariff tarif
payment-item platební položka

Rozdíly proti inzerci#

Bazaar Comcat
Cena ano ne
Prodáno ano ne
Sledující ano ne

Chybějící cena je záměr

Firma se neprodává. Ceny za zápis jsou na kategorii.

Odpověď na firemní profil#

response se chová stejně jako u inzerce: odesílatel odpovědi je owner, majitel profilu (inzerátu v katalogu) je owner i receiver a smí přečíst detail (get) a odpověď označit za přečtenou. Tajný klíč readKey pro odkaz „Označit jako přečtené“ v e-mailu zná jen web; přes HTTP se nezapisuje ani nevydává. Podrobně v Bazaar a v Oprávněních.

Profil nemá pevná pole#

Název, IČO, adresa i otevírací doba jsou parametry

Zjistěte z category-parameter-rel, co obor vyžaduje. Bez toho pošlete prázdný profil.

Otevírací doba#

Zvláštní typ parametru s vlastní strukturou hodnoty.

Uložení profilu nahradí celou sadu parametrů

Neposlete-li otevírací dobu, zmizí — a nic to neohlásí. Při úpravě posílejte kompletní sadu.

Viditelnost#

Profil je aktivní, jen když je schválený, zaplacený a není blokovaný, smazaný ani deaktivovaný. Příznak aktivity se nedá zapsat.

Čtení se filtruje stejně jako u inzerce: externí volající bez administrátorské role dostane z advert (get, get-by, get-all, search) jen profily aktivní a neprošlé (expirationDate je dnes nebo později) a své vlastní, z category jen aktivní obory. Skrytý profil zmizí i s vazbami a jeho get vypadá jako neexistující záznam. Podrobně v Bazaar.

Zápis profilu#

Platí stejné kontroly jako u zápisu inzerátu: pravidla parametrů (code: 2, errorCode parameterTooLong, parameterUrlNotAllowed, parameterBlacklistedWord, parameterRequired, parameterOptionNotAllowed), vypnutý obor nebo obor jen pro administrátora (615, advertCategoryNotAllowed), blacklist u nového profilu (615, blacklisted), obrázky nad limit v saveInfo.rejectedUploads s důvodem size a extend-expiration v placeném oboru (607, data: null). Odpověď na profil s údajem na blacklistu vrací 615, blacklisted.

Nastavení cookies