API

Добијање аналитике повратних информација

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

Враћа збирне плочице и график повратних информација за период. Свака тачка представља један сат у UTC; враћају се само непразне тачке. Интерфејс аутоматски конвертује време у временску зону корисника и групише сате по данима. Подразумевани период је данас. Период је ограничен на једну годину; дужи период се скраћује са краја. Плочица удела садржи dynamics — промену у односу на date_comparison_*. Ако овај период није наведен, подразумева се период исте дужине непосредно пре изабраног. Ова подразумевана вредност се примењује само на поређење и не враћа се у филтерима.

Ауторизација

api-token + language + role

Parametri upita

date_fromstring

Пример: 25/04/2024

date_tostring

Пример: 26/04/2024

date_comparison_fromstring

Пример: 25/03/2024

date_comparison_tostring

Пример: 26/03/2024

chain_idinteger

Пример: 1

branch_idinteger

Пример: 1

Одговори

OK

object
statusstringобавезно

Vrednosti:successerror

Пример: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringможе бити null

Пример: 2026-08-01 00:00:00

typestringобавезно

Пример: date

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

date_toobject (FilterDateTo)
valuestringможе бити null

Пример: 2026-08-31 23:59:59

typestringобавезно

Пример: date

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

date_rangeobject (FilterDateRange)

Gotovi periodi filtera po datumu; donja granica se računa u korisničkoj vremenskoj zoni. value — period kojem odgovaraju trenutni *_from i *_to; null — proizvoljan period. default — period koji server automatski postavlja u zahtev bez datuma: koristi se pri prvom učitavanju sekcije i pri resetovanju filtera. Gornja granica perioda uvek odgovara trenutnom danu korisnika, zato je option ne sadrži: nije potrebno slati *_to za gotov period, server je postavlja automatski. Period duži od godinu dana se skraćuje sa strane novije granice.

valuestring (DateRange) може бити null

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

defaultstring (DateRange) обавезно

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

typestringобавезно

Пример: select

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

optionarray of objectобавезно
valuestring (DateRange) обавезно

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

date_fromstringобавезно

Пример: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringможе бити null

Пример: 2026-08-01 00:00:00

typestringобавезно

Пример: date

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

date_comparison_toobject (FilterDateTo)
valuestringможе бити null

Пример: 2026-08-31 23:59:59

typestringобавезно

Пример: date

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Готови периоди за филтрирање датума без подразумеване вредности: default је увек null.

valuestring (DateRange) може бити null

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

defaultstring (DateRange) може бити null

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

typestringобавезно

Пример: select

optionarray of objectобавезно
valuestring (DateRange) обавезно

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

date_fromstringобавезно

Пример: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object
valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object
valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) обавезно

Плочица-бројач у сажетој линији: број рецензија и њихов удео за период. percent је null ако нема ниједне рецензије у периоду. Промена у односу на упоредни период се намерно не шаље: број рецензија зависи од саобраћаја, па његов раст не говори ништа о квалитету.

valueintegerобавезно

Пример: 96

percentnumber · float

Пример: 75

positiveobject (FeedbackAnalyticsCountTile) обавезно

Плочица-бројач у сажетој линији: број рецензија и њихов удео за период. percent је null ако нема ниједне рецензије у периоду. Промена у односу на упоредни период се намерно не шаље: број рецензија зависи од саобраћаја, па његов раст не говори ништа о квалитету.

valueintegerобавезно

Пример: 96

percentnumber · float

Пример: 75

negativeobject (FeedbackAnalyticsCountTile) обавезно

Плочица-бројач у сажетој линији: број рецензија и њихов удео за период. percent је null ако нема ниједне рецензије у периоду. Промена у односу на упоредни период се намерно не шаље: број рецензија зависи од саобраћаја, па његов раст не говори ништа о квалитету.

valueintegerобавезно

Пример: 96

percentnumber · float

Пример: 75

positive_shareobject (FeedbackAnalyticsShareTile) обавезно

Плочица удела у збирном реду. За разлику од бројача, садржи dynamics — промену удела у односу на период поређења у процентним поенима; не зависи од саобраћаја. percent и dynamics су null ако нема основа за израчунавање: нема рецензија за период или за период поређења.

valueintegerобавезно

Пример: 96

percentnumber · float

Пример: 75

dynamicsnumber · float

Пример: -0.2

pointsarray of object
datetimestringобавезно

Почетак временске тачке у UTC

Пример: 2026-09-08 10:00:00

positiveintegerобавезно

Пример: 3

negativeintegerобавезно

Пример: 1