api.tipmoto.com » Dokumentace API » Agendy » Seznam firem » Firma » Statistika

Agenda stats (statistika firmy)

Statistika firmy po dnech, týdnech nebo měsících, rozdělená po sekcích moto, dily, prislusenstvi a firma, a blok vybirame (Vybíráme z nabídky na MotoInzerce.cz): zobrazení detailu, zobrazení ve výpisu, prokliky, odpovědi, uložení do schránky, přehrání videa, akční okna a metriky firmy, poboček a e-shopů.
Vychází ze stejných počítadel a pravidel jako statistiky v administraci firmy a jako statistika jednoho inzerátu a tabulka inzerátů. Agenda je jen ke čtení a vyžaduje právo statsperm. Jak čísla vznikají a jak je číst, podrobně popisuje Metodika statistik.

Funkce agendy

Název Možnosti
Podporované metody GET
Podpora úrovně detailu ✔ (vlastní výběr metrik, viz úrovně detailu)
Podpora filtrace ✘
Podpora fulltextu ✘
Podpora stránkování ✘
Podpora řazení ✘
Podpora externích identifikátorů ✘
Podpora schémat https://api.tipmoto.com/schemas/stats.{xsd|rng}
Podpora ?fail-on-warning ✘
Podpora dry-run ✘
Vrací location ✘

Adresa

https://api.tipmoto.com/c/{ID firmy}/stats.{xml|json|html}

Oprávnění

Parametry

Parametr Hodnoty Výchozí Popis
period day, week, month day Délka jednoho období časové řady: den, týden (ISO, pondělí až neděle) nebo kalendářní měsíc.
from, to RRRR-MM-DD viz Rozsah První a poslední den rozsahu (včetně). Bere se přesně, nepřichytává se na celé týdny ani měsíce: okrajové období useknuté rozsahem má u metrik neuplne="rozsah" a jeho od/do říkají skutečně pokryté dny. Je-li from pozdější než to, prohodí se. Jen from: to = dnes. Jen to: from = to − 27 dní.
location 1, 2, 3, 4 (víc čárkou, např. 1,2) všechna umístění Filtr umístění. Jakýkoli filtr vyřadí dopočítanou historii (umístění 0), takže metriky pak začínají dnem, kdy se začalo měřit podle umístění. Metrika, blok nebo sekce, které ve vybraných umístěních nevznikají, v dokumentu chybí (např. s location=3 zůstanou jen zobrazeni a vypis sekce moto). Opakovaná hodnota se sloučí, prázdné location= znamená bez filtru, 0 je neplatná hodnota.
breakdown location – Rozpad podle umístění: v každém obdobi i v souhrn jsou navíc bloky umisteni, viz Rozpad podle umístění. Bloky akcniOkno a vybirame se při rozpadu přesunou do bloků umisteni a na úrovni obdobi/souhrn pak nejsou.
section moto, dily, prislusenstvi, firma (víc čárkou, např. moto,firma) všechny sekce Které sekce dokument obsahuje. Blok vybirame je mimo sekce a parametr section ho neovlivňuje. Opakovaná hodnota se sloučí, prázdné section= znamená všechny sekce.
detail id, summary, full, custom:… full Které metriky dokument obsahuje, viz úrovně detailu.
no-series true (1), false (0) false true = dokument bez časové řady rada, jen se souhrnem. Zmenší odpověď.
standardní lang, xpath, code-in-response, no-http-errors, sessionid   Fungují jako v celém API, viz URL parametry. xpath vrací XML i u .json.
nepodporované order, filter, limit, start, add-row-count, fulltext, ftx-loc, usrval-show   Statistika firmy je nepodporuje a vrátí 406, jakmile má parametr neprázdnou hodnotu, i 0 (limit=0 je chyba). Parametr s prázdnou hodnotou (limit=) se bere jako neuvedený.

Neplatná hodnota parametru period, from, to, location, breakdown, section, detail nebo no-series vrátí 400 s hláškou, která vyjmenuje povolené hodnoty. Na velikosti písmen záleží.

Úrovně detailu

Hodnota Obsah
id Identifikace firmy, rozsah a pokrytí metriky jako u full – bez čísel (bez souhrn a rada).
summary Pět základních metrik inzerátů v sekcích moto, dily a prislusenstvi: zobrazeni, vypis, urlKliknuti, odpovedi, schranka. Sekce firma a blok vybirame v něm nejsou.
full (výchozí) Navíc videoPrehrani, videoDokoukano, bloky akcniOkno a vybirame a metriky sekce firma: pobocky, eshopy, stranky, formulare, poptavky, web.
custom:… Jen vyjmenované metriky a bloky, čárkou: zobrazeni, vypis, urlKliknuti, odpovedi, schranka, videoPrehrani, videoDokoukano, akcniOkno, vybirame, pobocky, eshopy, stranky, formulare, poptavky, web. Např. detail=custom:zobrazeni,odpovedi. Neznámé položky se ignorují jako v celém API (i videoUdrzeni, které je jen ve statistice inzerátu); obsahuje-li seznam jen neznámé položky, dokument je jako u detail=id.

Sekce bez jediné vybrané metriky se nevypíše, a to ani v metriky (např. section=firma&detail=custom:zobrazeni sekci firma nevypíše). Není to chyba. Když ve výběru nevzniká vůbec nic (jako v tomto příkladu nebo video u firmy, která video nikdy neměla), dokument má souhrn jen s od, do a řadu s prázdnými obdobi; rozsah se nezužuje.

Umístění

Kde návštěvník inzerát nebo firmu viděl. Číslo umístění je v prvku lokace; číselník je v agendě lokacestats.

lokace Umístění
0 Nerozlišeno – historie dopočítaná ze záloh (do dopoctenoDo). Objevuje se jen v rozpadu breakdown=location, filtrovat podle ní nelze.
1 www.tipmoto.com
2 Firemní subdoména
3 Výpis na webu klienta (vložený výpis web.tipmoto.com)
4 MotoInzerce.cz

Rozsah

Nula a neměřeno

Neúplné hodnoty (neuplne)

Atribut neuplne na metrice říká, že hodnota pokrývá jen část období, a proč. Víc důvodů je oddělených čárkou v tomto pořadí:

Důvod Význam
rozsah Období je useknuté rozsahem (týden nebo měsíc na okraji from/to). V souhrnu nevzniká – ten pokrývá právě použitý rozsah.
mereni Metrika v období začala měřit, má v něm mezeru v datech, nebo jde o neúplný první den měření (4. 9. 2026 u urlKliknuti, 7. 9. 2026 u schranka, formulare, poptavky a web, 24. 9. 2026 u videa, viz katalog); stačí, když to platí v jednom ze sečtených umístění.
bezi Období ještě neskončilo (obsahuje dnešek). I v souhrnu, když rozsah obsahuje dnešek.

Důvod zivot ze statistiky inzerátu tady nevzniká – statistika firmy nemá život inzerátu a nic se na něj neořezává.

Souhrn (dni, prumerDen)

Roboti

Pokrytí metrik (metriky)

Blok metriky je v dokumentu jednou a popisuje pokrytí přesně pro data v dokumentu (zvolenou granularitu, filtr location a vybrané sekce). Je rozdělený po sekcích: obsahuje prvky moto, dily, prislusenstvi a firma ve stejném pořadí jako data a v každém prvky metrika s pokrytím té sekce (např. mezera v datech odpovedi 31. 8.–7. 9. 2026 je jen v prislusenstvi, akcniOkno v dily má jen pokryti umístění 2). metrika bloku vybirame je přímo v metriky, za sekcemi. Metrika, která ve vybraných umístěních či v sekci nevzniká (např. video u dílů), v bloku není; sekce bez metrik také ne.

Katalog metrik

Klíč Název Sekce a umístění, kde vzniká Data od Detail
zobrazeni Zobrazení detailu moto: 1, 2, 3
dily: 1, 2
prislusenstvi: 1, 2		 viz dostupnost dat; do 28. 8. 2026 dopočet ze záloh, měřeno od 29. 8. 2026 summary
vypis Zobrazení ve výpisu moto: 1, 2, 3
dily: 1, 2
prislusenstvi: 1, 2		 29. 8. 2026 summary
urlKliknuti Proklik na web prodejce moto: 1, 2
dily: 1, 2
prislusenstvi: 1		 4. 9. 2026 (první den neúplný) summary
odpovedi Odpovědi na inzerát moto: 1, 2
dily: 1, 2
prislusenstvi: 1		 viz dostupnost dat; do 7. 9. 2026 dopočet ze záloh, měřeno od 8. 9. 2026. U příslušenství dopočet do 30. 8. 2026 a mezera v datech 31. 8.–7. 9. 2026 summary
schranka Uloženo do schránky moto: 1, 2
dily: 1, 2
prislusenstvi: 1		 7. 9. 2026 (první den neúplný) summary
videoPrehrani Přehrání videa moto: 1, 2 24. 9. 2026 (první den neúplný), u firmy až od prvního dne s videem (viz Video) full
videoDokoukano Dokoukáno (video) moto: 1, 2 24. 9. 2026 (první den neúplný), u firmy až od prvního dne s videem nahraným na TipMoto full
akcniOkno Akční okno – blok v sekci s lokace a metrikami zobrazeni (zobrazení akčního okna), proklik (proklik z akčního okna) a proklikFirma (proklik na jméno firmy; jen v sekci moto, v umístění 1 a 4 – akční okno dílů je jen na firemní subdoméně; bez sekce moto v section se nevrátí) moto: 1, 2, 4
dily: 2
prislusenstvi: nemá		 29. 8. 2026; v umístění 4 mezera v datech 15.–16. 9. 2026 full
vybirame Vybíráme z nabídky (výpis na MotoInzerce.cz) – blok mimo sekce s lokace a metrikami zobrazeni (zobrazení výpisu), proklik (proklik na inzerát) a proklikLogo (proklik na logo) mimo sekce: 4 29. 8. 2026; mezera v datech 15.–16. 9. 2026 full
pobocky Detail pobočky (zobrazení detailu pobočky) firma: 1, 2 29. 8. 2026 full
eshopy Detail e-shopu (zobrazení detailu e-shopu) firma: 1, 2 29. 8. 2026 full
stranky Zobrazené stránky (stránky firmy: firemní subdoména a stránky na www s firmou v URL) firma: 1, 2 29. 8. 2026 full
formulare Formuláře z detailu (formuláře odeslané z detailu firmy a e-shopu) firma: 1, 2 7. 9. 2026 (první den neúplný) full
poptavky Poptávky a nabídky (doručené poptávky a nabídky) firma: 1, 2 7. 9. 2026 (první den neúplný) full
web Proklik na web firmy firma: 1, 2 7. 9. 2026 (první den neúplný) full

Umístění viz tabulka umístění; kombinace mimo tabulku neexistuje a v dokumentu chybí. Po měsících jsou data metrik měřených od roku 2026 od prvního měsíce měření. Nový sběr odděluje roboty od prvního dne měření (robotiOd = merenoOd).

Video

Příklad section=moto&detail=custom:videoPrehrani,videoDokoukano&from=2026-09-22 (dotaz podaný 27. 9. 2026, zkráceno) – video se měří od 24. 9. 2026, proto API rozsah zúžilo a zadaný začátek je v pozadovanoOd: 

<rozsah>
  <od>2026-09-24</od>
  <do>2026-09-27</do>
  <period>day</period>
  <pozadovanoOd>2026-09-22</pozadovanoOd>
  <section>moto</section>
</rozsah>
…
<souhrn>
  <od>2026-09-24</od>
  <do>2026-09-27</do>
  <moto>
    <videoPrehrani dni="2" prumerDen="22.50" neuplne="mereni,bezi" roboti="0" aiRoboti="0">94</videoPrehrani>
    <videoDokoukano dni="2" prumerDen="10.50" neuplne="mereni,bezi" roboti="0" aiRoboti="0">42</videoDokoukano>
  </moto>
</souhrn>

Rozpad podle umístění

Příklad breakdown=location&from=2026-09-14&to=2026-09-16&no-series=true, blok umístění 4 v souhrnu: 

<umisteni>
  <lokace>4</lokace>
  <moto>
    <akcniOkno>
      <lokace>4</lokace>
      <zobrazeni dni="1" prumerDen="5670.00" neuplne="mereni" roboti="6388" aiRoboti="2647">5670</zobrazeni>
      <proklik dni="1" prumerDen="4.00" neuplne="mereni" roboti="0" aiRoboti="0">4</proklik>
      <proklikFirma dni="1" prumerDen="1.00" neuplne="mereni" roboti="0" aiRoboti="0">1</proklikFirma>
    </akcniOkno>
  </moto>
  <vybirame>
    <lokace>4</lokace>
    <zobrazeni dni="1" prumerDen="0.00" neuplne="mereni" roboti="0" aiRoboti="0">0</zobrazeni>
    <proklik dni="1" prumerDen="0.00" neuplne="mereni" roboti="0" aiRoboti="0">0</proklik>
    <proklikLogo dni="1" prumerDen="0.00" neuplne="mereni" roboti="0" aiRoboti="0">0</proklikLogo>
  </vybirame>
</umisteni>

Umístění 4 mělo 15.–16. 9. 2026 mezeru v datech, proto je v něm jen jeden celý den (dni="1") a neuplne="mereni".

Položky agendy

Str. název Název Typ Informace
id ID firmy integer  
id@ref Odkaz na přehled firmy href /c/{ID firmy} ve formátu požadavku.
rozsah/od, rozsah/do Použitý rozsah date Chybí u prázdného rozsahu.
rozsah/period Délka období select day, week, month; vždy.
rozsah/pozadovanoOd, rozsah/pozadovanoDo Požadovaný rozsah date Zadaný okraj (po doplnění výchozích hodnot a prohození), jen když se liší od použitého; u prázdného rozsahu vždy.
rozsah/location Filtr umístění string Jen když byl parametr použitý, např. 1,2.
rozsah/breakdown Rozpad select location; jen když byl parametr použitý.
rozsah/section Vybrané sekce string Jen když byl parametr použitý, např. moto,firma.
metriky/{sekce}/metrika, metriky/metrika Pokrytí metriky element Potomci klic, nazev, od, uplneOd, dopoctenoDo, merenoOd, robotiOd, dira, pokryti, poznamka, viz katalog a Pokrytí metrik. Přímo v metriky je jen metrika bloku vybirame.
souhrn Souhrn za rozsah element od, do, sekce, blok vybirame a (při rozpadu) umisteni.
rada/obdobi Jedno období řady element od, do (skutečně pokryté dny), tyden (jen period=week, např. 2026-W38), mesic (jen period=month, např. 2026-09), sekce, blok vybirame a (při rozpadu) umisteni.
moto, dily, prislusenstvi, firma Sekce element Metriky sekce v pořadí katalogu a za nimi bloky akcniOkno. Sekce, která v období nic neměřila, chybí.
{metrika} Hodnota metriky integer Lidé a neurčení návštěvníci, viz katalog.
{metrika}@roboti, {metrika}@aiRoboti Roboti, AI roboti integer Viz Roboti.
{metrika}@neuplne Neúplná hodnota set rozsah, mereni, bezi (čárkou).
{metrika}@dni, {metrika}@prumerDen Počet dní, průměr za den integer, decimal Jen v souhrn.
akcniOkno, vybirame, umisteni Bloky podle umístění element Umístění je v potomkovi lokace, za ním metriky (v umisteni sekce a blok vybirame toho umístění). akcniOkno je uvnitř sekce, vybirame za sekcemi. Bloky jsou seřazené podle lokace vzestupně.

Pořadí potomků je pevné: v obdobi a souhrn identifikace (od, do, tyden/mesic), sekce v pořadí moto, dily, prislusenstvi, firma, blok vybirame, bloky umisteni; v sekci metriky v pořadí katalogu a bloky akcniOkno.

Příklad

GET /c/95/stats.xml?period=month&from=2026-07-01&to=2026-09-27&section=moto,firma (dotaz podaný 27. 9. 2026, zkráceno): 

<!--Dokumentace agendy na: https://api.tipmoto.com/docs/agendas/stats/
  Schémata (více o nich na https://api.tipmoto.com/docs/ref/schemata/ ):
    https://api.tipmoto.com/schemas/stats.xsd
    https://api.tipmoto.com/schemas/stats.rng-->
<tipmoto>
  <!--Statistika firmy po sekcích (součet přes sekce není, smazané inzeráty jsou v součtech). Hodnota 0 = měřilo se a nikdo nepřišel, chybějící metrika nebo sekce = neměřilo se. Hlavní číslo = lidé a neurčení návštěvníci, roboti jsou v atributech.-->
  <stats>
    <id ref="/c/95.xml">95</id>
    <!--Skutečně použitý rozsah. pozadovanoOd/pozadovanoDo jsou jen tehdy, když API rozsah zúžilo (budoucnost, začátek dat, celé měsíce mimo denní data); location, breakdown a section jen tehdy, když byly parametry použité.-->
    <rozsah>
      <od>2026-07-01</od>
      <do>2026-09-27</do>
      <period>month</period>
      <section>moto,firma</section>
    </rozsah>
    <!--Pokrytí metrik v tomto dokumentu po sekcích: od = první den s daty (pro zvolenou granularitu a umístění), dopoctenoDo = do kdy jsou hodnoty dopočítané ze záloh, merenoOd = od kdy jde o nové měření, robotiOd = od kdy jsou roboti oddělení (atributy roboti a aiRoboti).-->
    <metriky>
      <moto>
        <metrika>
          <klic>zobrazeni</klic>
          <nazev>Zobrazení detailu</nazev>
          <od>2022-05-01</od>
          <dopoctenoDo>2026-08-28</dopoctenoDo>
          <merenoOd>2026-08-29</merenoOd>
          <robotiOd>2026-08-29</robotiOd>
        </metrika>
        <!-- … vypis, urlKliknuti, odpovedi, schranka, videoPrehrani, videoDokoukano -->
        <metrika>
          <klic>akcniOkno</klic>
          <nazev>Akční okno</nazev>
          <od>2026-08-29</od>
          <merenoOd>2026-08-29</merenoOd>
          <robotiOd>2026-08-29</robotiOd>
          <pokryti>
            <lokace>1</lokace>
            <od>2026-08-29</od>
          </pokryti>
          <!-- … pokryti 2 -->
          <pokryti>
            <lokace>4</lokace>
            <od>2026-08-29</od>
            <dira>
              <od>2026-09-15</od>
              <do>2026-09-16</do>
            </dira>
          </pokryti>
        </metrika>
      </moto>
      <firma>
        <metrika>
          <klic>pobocky</klic>
          <nazev>Detail pobočky</nazev>
          <od>2026-08-29</od>
          <merenoOd>2026-08-29</merenoOd>
          <robotiOd>2026-08-29</robotiOd>
        </metrika>
        <!-- … eshopy, stranky, formulare, poptavky, web -->
      </firma>
      <metrika>
        <klic>vybirame</klic>
        <nazev>Vybíráme z nabídky</nazev>
        <od>2026-08-29</od>
        <merenoOd>2026-08-29</merenoOd>
        <robotiOd>2026-08-29</robotiOd>
        <dira>
          <od>2026-09-15</od>
          <do>2026-09-16</do>
        </dira>
        <pokryti>
          <lokace>4</lokace>
          <od>2026-08-29</od>
          <dira>
            <od>2026-09-15</od>
            <do>2026-09-16</do>
          </dira>
        </pokryti>
      </metrika>
    </metriky>
    <!--Součty za použitý rozsah. dni = počet celých dnů, kdy se metrika měřila (bez neúplných dnů a bez dneška), prumerDen = součet za tyto dny / dni. neuplne = hodnota je jen za část rozsahu (mereni, bezi).-->
    <souhrn>
      <od>2026-07-01</od>
      <do>2026-09-27</do>
      <moto>
        <zobrazeni dni="88" prumerDen="5.30" neuplne="bezi">469</zobrazeni>
        <vypis dni="29" prumerDen="236.62" neuplne="mereni,bezi" roboti="612" aiRoboti="259">7024</vypis>
        <!-- … urlKliknuti, odpovedi, schranka, videoPrehrani, videoDokoukano -->
        <akcniOkno>
          <lokace>1</lokace>
          <zobrazeni dni="29" prumerDen="0.00" neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</zobrazeni>
          <proklik dni="29" prumerDen="0.00" neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</proklik>
          <proklikFirma dni="29" prumerDen="0.00" neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</proklikFirma>
        </akcniOkno>
        <akcniOkno>
          <lokace>2</lokace>
          <zobrazeni dni="29" prumerDen="0.00" neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</zobrazeni>
          <proklik dni="29" prumerDen="0.00" neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</proklik>
        </akcniOkno>
        <!-- … akcniOkno 4 -->
      </moto>
      <firma>
        <pobocky dni="29" prumerDen="0.55" neuplne="mereni,bezi" roboti="17" aiRoboti="5">16</pobocky>
        <!-- … eshopy, stranky, formulare, poptavky -->
        <web dni="19" prumerDen="0.05" neuplne="mereni,bezi" roboti="0" aiRoboti="0">1</web>
      </firma>
      <vybirame>
        <lokace>4</lokace>
        <zobrazeni dni="27" prumerDen="0.00" neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</zobrazeni>
        <proklik dni="27" prumerDen="0.00" neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</proklik>
        <proklikLogo dni="27" prumerDen="0.00" neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</proklikLogo>
      </vybirame>
    </souhrn>
    <!--Časová řada: jeden prvek obdobi na den, týden (ISO) nebo měsíc; od/do jsou skutečně pokryté dny.-->
    <rada>
      <obdobi>
        <od>2026-07-01</od>
        <do>2026-07-31</do>
        <mesic>2026-07</mesic>
        <moto>
          <zobrazeni>127</zobrazeni>
          <odpovedi>0</odpovedi>
        </moto>
      </obdobi>
      <!-- … obdobi 2026-08 -->
      <obdobi>
        <od>2026-09-01</od>
        <do>2026-09-27</do>
        <mesic>2026-09</mesic>
        <moto>
          <zobrazeni neuplne="bezi" roboti="63" aiRoboti="8">211</zobrazeni>
          <!-- … vypis, urlKliknuti, odpovedi, schranka, videoPrehrani, videoDokoukano, akcniOkno -->
        </moto>
        <firma>
          <pobocky neuplne="bezi" roboti="16" aiRoboti="5">16</pobocky>
          <!-- … eshopy, stranky, formulare, poptavky, web -->
        </firma>
        <vybirame>
          <lokace>4</lokace>
          <zobrazeni neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</zobrazeni>
          <proklik neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</proklik>
          <proklikLogo neuplne="mereni,bezi" roboti="0" aiRoboti="0">0</proklikLogo>
        </vybirame>
      </obdobi>
    </rada>
  </stats>
</tipmoto>

V červenci 2026 se měřily jen zobrazeni a odpovedi (dopočet ze záloh), ostatní metriky a sekce firma i blok vybirame v tom období chybí. zobrazeni v souhrnu nemá atributy robotů, protože rozsah začíná před jeho robotiOd.

JSON

GET /c/5/stats.json?section=moto&detail=custom:zobrazeni,akcniOkno&from=2026-09-15&to=2026-09-15 (odřádkováno). Akční okno v umístění 4 mělo 15. 9. 2026 mezeru v datech, proto v dokumentu chybí: 

{
  "tipmoto": {
    "stats": {
      "id": "5",
      "rozsah": {"od": "2026-09-15", "do": "2026-09-15", "period": "day", "section": "moto"},
      "metriky": {"moto": {"metrika": [
        {"klic": "zobrazeni", "nazev": "Zobrazení detailu", "od": "2025-08-01", "dopoctenoDo": "2026-08-28", "merenoOd": "2026-08-29", "robotiOd": "2026-08-29"},
        {"klic": "akcniOkno", "nazev": "Akční okno", "od": "2026-08-29", "merenoOd": "2026-08-29", "robotiOd": "2026-08-29", "pokryti": [{"lokace": "1", "od": "2026-08-29"}, {"lokace": "2", "od": "2026-08-29"}]}
      ]}},
      "souhrn": {
        "od": "2026-09-15", "do": "2026-09-15",
        "moto": {
          "zobrazeni": "1585",
          "akcniOkno": [
            {"lokace": "1", "zobrazeni": "0", "proklik": "0", "proklikFirma": "0", "zobrazeni@dni": "1", "zobrazeni@prumerDen": "0.00", "zobrazeni@roboti": "0", "zobrazeni@aiRoboti": "0", "proklik@dni": "1", "proklik@prumerDen": "0.00", "proklik@roboti": "0", "proklik@aiRoboti": "0", "proklikFirma@dni": "1", "proklikFirma@prumerDen": "0.00", "proklikFirma@roboti": "0", "proklikFirma@aiRoboti": "0"},
            {"lokace": "2", "zobrazeni": "28", "proklik": "0", "zobrazeni@dni": "1", "zobrazeni@prumerDen": "28.00", "zobrazeni@roboti": "12", "zobrazeni@aiRoboti": "8", "proklik@dni": "1", "proklik@prumerDen": "0.00", "proklik@roboti": "0", "proklik@aiRoboti": "0"}
          ],
          "zobrazeni@dni": "1", "zobrazeni@prumerDen": "1585.00", "zobrazeni@roboti": "706", "zobrazeni@aiRoboti": "136"
        }
      },
      "rada": {"obdobi": [
        {"od": "2026-09-15", "do": "2026-09-15", "moto": {
          "zobrazeni": "1585",
          "akcniOkno": [
            {"lokace": "1", "zobrazeni": "0", "proklik": "0", "proklikFirma": "0", "zobrazeni@roboti": "0", "zobrazeni@aiRoboti": "0", "proklik@roboti": "0", "proklik@aiRoboti": "0", "proklikFirma@roboti": "0", "proklikFirma@aiRoboti": "0"},
            {"lokace": "2", "zobrazeni": "28", "proklik": "0", "zobrazeni@roboti": "12", "zobrazeni@aiRoboti": "8", "proklik@roboti": "0", "proklik@aiRoboti": "0"}
          ],
          "zobrazeni@roboti": "706", "zobrazeni@aiRoboti": "136"
        }}
      ]},
      "id@ref": "/c/5.json"
    }
  }
}

Chyby

Chyba má tvar <tipmoto><chyby><chyba>…</chyba></chyby></tipmoto> ve formátu požadavku (.xml, .json, .html) a respektuje lang, code-in-response a no-http-errors, viz Obsluha chyb.

HTTP kód Kdy
400 neplatná hodnota parametru period, from, to, location (i 0), breakdown, section, detail nebo no-series; hláška vyjmenuje povolené hodnoty
402 login nemá k firmě právo statsperm (i když k firmě nemá přístup vůbec); firma je pozastavená nebo nemá povolené exporty
404 adresa neexistuje
405 jiná metoda než GET
406 nepodporovaný parametr (order, filter, limit, start, add-row-count, fulltext, ftx-loc, usrval-show, i s hodnotou 0); chybný xpath; dotaz je příliš náročný – zkraťte rozsah, použijte period=month nebo vyberte méně metrik (detail=custom:…)
500 chyba při vykonání dotazu na našem serveru
503 databázový server je nedostupný; požadavek zopakujte později

Příklad period=blbost: 

<tipmoto>
  <success>false</success>
  <chyby>
    <chyba>Neplatná hodnota 'blbost' URL parametru 'period'. Povolené hodnoty jsou 'day', 'week' a 'month'.</chyba>
  </chyby>
</tipmoto>

Příklad limit=10: 

<tipmoto>
  <chyby>
    <chyba>Statistika firmy nepodporuje parametr 'limit' (filtrace, řazení ani stránkování u ní nejsou).</chyba>
  </chyby>
</tipmoto>

Rozšiřitelnost

Prvky, atributy i hodnoty (např. nové metriky, bloky, sekce nebo důvody neuplne) mohou přibývat; význam existujícího prvku se nemění. Neznámé prvky, atributy a hodnoty ignorujte. Nové prvky přibývají na konec pevného pořadí. Klient, který výstup validuje, musí po rozšíření použít aktuální schéma. Každé rozšíření zapíšeme do changelogu.

TipMoto.com Kontaktujte nás