Agenda motoceny

Cenová služba MotoCeny: stažené inzeráty motocyklů s cenou a s tím, jak dlouho byl inzerát na serveru.
Vypisuje totéž, co klientské rozhraní na www.tipmoto.com/motoceny/, se stejnými pravidly.

Přístup k agendě vyžaduje, aby login byl vlastním webem firmy (nastavení firma_self) – cizí exportní server do agendy nemá přístup – a aby firma měla aktivovanou inzerci motocyklů. Máte-li navíc aktivovanou službu MotoCeny, vidíte celý trh (jen inzeráty firem, které se do služby zapojily); bez ní vidíte pouze inzeráty své firmy. Bez oprávnění agenda vrací 402.

Nevrací se ID inzerátu ani prodávající firma. Vlastní inzeráty poznáte podle položky vlastni.
Úrovně detailu: podporován je pouze detail=custom:…; bez parametru se vypisují všechny položky.
Stránkování: výchozí i maximální limit je 1000.
Fulltext: parametr fulltext= používá stejné hledání jako web; ftx-op a ftx-loc tato agenda nezná.

Funkce agendy

Název	Možnosti
Podporované metody	GET
Podpora úrovně detailu	✔ pouze custom
Podpora filtrace	✔
Podpora fulltextu	✔ pouze fulltext=
Podpora stránkování	✔ limit nejvýše 1000
Podpora řazení	✔
Podpora externích identifikátorů	✘
Podpora schémat	https://api.tipmoto.com/schemas/motoceny.{xsd|rng}
Podpora ?fail-on-warning	✘
Podpora dry-run	✘
Vrací location	✘

Položky agendy

Str. název	Název	Typ	Informace	rw	P	S	➀	➁
manufacturer	Výrobce	string 64				✔
nazev	Název inzerátu	string 64				✔
model	Model	string 64	Model dle číselníku. Může být prázdný (u starších inzerátů nebyl zadán). Atribut id je ID modelu v číselníku, ref odkaz na jeho detail. Není-li model z číselníku, atributy nejsou uvedeny vůbec – ne prázdné. Filtrovat a řadit lze podle model@id			✔
zarazenimoto	Typ (zařazení)	string 64				✔
objem	Objem motoru	string 16	V ccm. Není to číslo – může být i elektro, nebo prázdné Ve filtraci a řazení se převádí na číslo elektro se chová jako 0, takže z rozsahů s dolní hranicí vypadne Stejně se chová i hledání na webu			✔
vykon	Výkon	decimal 4,1	V kW. 0.0 = neuvedeno			✔
vyrobeno	Rok výroby	string 8	Může být prázdný. Ve filtraci a řazení se převádí na číslo.			✔
najeto	Nájezd	string 16	Může být prázdný			✔
najetoMira	Jednotka nájezdu	string 8	Obvykle km nebo mi			✔
stk	Technická kontrola	select	Možné hodnoty: 0 ne 1 ano 2, 3 neuvedeno (web tyto hodnoty nezobrazuje)			✔
cena	Cena	integer	Inzerovaná cena v době stažení inzerátu. 0 = cena dohodou			✔
cenaMena	Měna	string 8	Obvykle Kč nebo €, z historických důvodů i jiné textové hodnoty			✔
vlozeniCas	Datum vložení	date	Pouze den, bez času – stejně jako u data stažení			✔
smazaniCas	Datum stažení	date	Pouze den, bez času – stejně jako na webu			✔
delkaProdeje	Délka inzerce ve dnech	integer	Počet dní, kdy byl inzerát na serveru. Stažení není totéž co prodej Inzerát mohl být stažen i z jiného důvodu			✔
vlastni	Vlastní inzerát	select	Je to inzerát Vaší firmy? 0 ne 1 ano Lze podle něj filtrovat: filter=vlastni='1'			✔

rw = lze zapisovat
P = povinná položka
S = dle položky lze filtrovat a řadit
➀ = je v detailu id
➁ = je v detailu summary