API

Získat analytiku zpětné vazby

GET/api/crm/v2/feedback_analyticsv2
operationId: feedbackAnalytics.default

Vrací souhrnné dlaždice a graf zpětné vazby za období. Každý bod představuje jednu hodinu v UTC; vracejí se pouze body s daty. Rozhraní samo převádí čas do časového pásma uživatele a seskupuje hodiny do dnů. Výchozí období je dnešek. Období je omezeno na jeden rok; delší období je zkráceno od nejnovějších dat. Dlaždice s podílem obsahuje dynamics — změnu vzhledem k date_comparison_*. Pokud toto období není zadáno, výchozí je období stejné délky bezprostředně před vybraným. Tato výchozí hodnota se použije pouze pro porovnání a nevrací se ve filtrech.

Autorizace

api-token + language + role

Parametry dotazu

date_fromstring

Příklad: 25/04/2024

date_tostring

Příklad: 26/04/2024

date_comparison_fromstring

Příklad: 25/03/2024

date_comparison_tostring

Příklad: 26/03/2024

chain_idinteger

Příklad: 1

branch_idinteger

Příklad: 1

Odpovědi

OK

object
statusstringpovinné

Hodnoty:successerror

Příklad: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringmůže být null

Příklad: 2026-08-01 00:00:00

typestringpovinné

Příklad: date

modestring (FilterMode)

Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.

Hodnoty:force_shownvalue_required

Příklad: value_required

date_toobject (FilterDateTo)
valuestringmůže být null

Příklad: 2026-08-31 23:59:59

typestringpovinné

Příklad: date

modestring (FilterMode)

Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.

Hodnoty:force_shownvalue_required

Příklad: value_required

date_rangeobject (FilterDateRange)

Přednastavená období filtru podle data; dolní hranice je vypočítána v časovém pásmu uživatele. value — období, kterému odpovídají aktuální *_from a *_to; null — vlastní období. default — období, které server nastaví v požadavku bez dat: použije se také při prvním načtení sekce a při resetování. Horní hranice období je vždy rovna aktuálnímu dni uživatele, proto ji option neobsahuje: pro přednastavené období není třeba předávat *_to, server ji nastaví sám. Období delší než jeden rok je zkráceno na straně novější hranice.

valuestring (DateRange) může být null

Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.

Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Příklad: today

defaultstring (DateRange) povinné

Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.

Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Příklad: today

typestringpovinné

Příklad: select

modestring (FilterMode)

Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.

Hodnoty:force_shownvalue_required

Příklad: value_required

optionarray of objectpovinné
valuestring (DateRange) povinné

Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.

Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Příklad: today

date_fromstringpovinné

Příklad: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringmůže být null

Příklad: 2026-08-01 00:00:00

typestringpovinné

Příklad: date

modestring (FilterMode)

Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.

Hodnoty:force_shownvalue_required

Příklad: value_required

date_comparison_toobject (FilterDateTo)
valuestringmůže být null

Příklad: 2026-08-31 23:59:59

typestringpovinné

Příklad: date

modestring (FilterMode)

Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.

Hodnoty:force_shownvalue_required

Příklad: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Přednastavená období filtrování dat bez výchozí hodnoty: default je vždy null.

valuestring (DateRange) může být null

Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.

Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Příklad: today

defaultstring (DateRange) může být null

Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.

Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Příklad: today

typestringpovinné

Příklad: select

optionarray of objectpovinné
valuestring (DateRange) povinné

Předdefinované období filtru podle data. Nemá vlastní parametr dotazu: dolní hranice je již vypočítána v option a je použita v *_from. Horní hranice není vrácena v odpovědi ani odeslána v dotazu — vždy odpovídá aktuálnímu dni uživatele a je nastavena serverem.

Hodnoty:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Příklad: today

date_fromstringpovinné

Příklad: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Příklad: 8920

typestringpovinné

Příklad: select

optionarray of object
valueintegerpovinné

Příklad: 8920

namestringpovinné

Příklad: Green Basket | Kaliningrad

modestring (FilterMode)

Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.

Hodnoty:force_shownvalue_required

Příklad: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Příklad: 8920

typestringpovinné

Příklad: select

optionarray of object
valueintegerpovinné

Příklad: 8920

namestringpovinné

Příklad: Green Basket | Kaliningrad

modestring (FilterMode)

Jak rozhraní zpracovává filtr; běžný filtr nemá mode. force_shown — vždy zobrazen, nelze skrýt. value_required — vstupní bod do sekce: vždy zobrazen, nemůže mít prázdnou hodnotu (dokud není vybrána hodnota, seznam je prázdný; varianta „vše“ není k dispozici), globální reset jej nevymaže.

Hodnoty:force_shownvalue_required

Příklad: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) povinné

Dlaždice s počítadlem v souhrnném řádku: počet recenzí a jejich podíl za období. percent je null, pokud za období není žádná recenze. Změna vůči porovnávanému období se záměrně nepředává: počet recenzí závisí na provozu, takže jeho růst nic nevypovídá o kvalitě.

valueintegerpovinné

Příklad: 96

percentnumber · float

Příklad: 75

positiveobject (FeedbackAnalyticsCountTile) povinné

Dlaždice s počítadlem v souhrnném řádku: počet recenzí a jejich podíl za období. percent je null, pokud za období není žádná recenze. Změna vůči porovnávanému období se záměrně nepředává: počet recenzí závisí na provozu, takže jeho růst nic nevypovídá o kvalitě.

valueintegerpovinné

Příklad: 96

percentnumber · float

Příklad: 75

negativeobject (FeedbackAnalyticsCountTile) povinné

Dlaždice s počítadlem v souhrnném řádku: počet recenzí a jejich podíl za období. percent je null, pokud za období není žádná recenze. Změna vůči porovnávanému období se záměrně nepředává: počet recenzí závisí na provozu, takže jeho růst nic nevypovídá o kvalitě.

valueintegerpovinné

Příklad: 96

percentnumber · float

Příklad: 75

positive_shareobject (FeedbackAnalyticsShareTile) povinné

Dlaždice podílu v souhrnném řádku. Na rozdíl od počítadel obsahuje dynamics — změnu podílu vůči srovnávacímu období v procentních bodech; nezávisí na provozu. percent a dynamics jsou null, pokud není co dělit: nejsou žádné recenze za období nebo za srovnávací období.

valueintegerpovinné

Příklad: 96

percentnumber · float

Příklad: 75

dynamicsnumber · float

Příklad: -0.2

pointsarray of object
datetimestringpovinné

Začátek hodinového intervalu v UTC

Příklad: 2026-09-08 10:00:00

positiveintegerpovinné

Příklad: 3

negativeintegerpovinné

Příklad: 1