API

Obțineți analiza feedback-ului

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

Returnează plăci sumare și un grafic al recenziilor pentru perioada selectată. Fiecare punct reprezintă o oră în UTC; sunt returnate doar punctele care nu sunt goale. Interfața convertește automat timpul în fusul orar al utilizatorului și grupează orele pe zile. Perioada implicită este astăzi. Perioada este limitată la un an; perioadele mai lungi sunt tăiate de la datele cele mai recente. Placa de proporție conține dynamics — modificarea față de date_comparison_*. Dacă această perioadă nu este specificată, implicit se folosește o perioadă de aceeași lungime imediat anterioară celei selectate. Această valoare implicită se aplică doar pentru comparație și nu este returnată în filtre.

Autorizare

api-token + language + role

Parametri de interogare

date_fromstring

Exemplu: 25/04/2024

date_tostring

Exemplu: 26/04/2024

date_comparison_fromstring

Exemplu: 25/03/2024

date_comparison_tostring

Exemplu: 26/03/2024

chain_idinteger

Exemplu: 1

branch_idinteger

Exemplu: 1

Răspunsuri

OK

object
statusstringobligatoriu

Valori:successerror

Exemplu: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringpoate fi null

Exemplu: 2026-08-01 00:00:00

typestringobligatoriu

Exemplu: date

modestring (FilterMode)

Cum interfața procesează filtrul; filtrul obișnuit nu are mode. force_shown — este întotdeauna afișat, nu poate fi ascuns. value_required — punct de intrare în secțiune: este întotdeauna afișat, nu poate avea valoare goală (până când nu este selectată o valoare, lista este goală; nu există opțiunea „toate”), resetarea generală nu îl curăță.

Valori:force_shownvalue_required

Exemplu: value_required

date_toobject (FilterDateTo)
valuestringpoate fi null

Exemplu: 2026-08-31 23:59:59

typestringobligatoriu

Exemplu: date

modestring (FilterMode)

Cum interfața procesează filtrul; filtrul obișnuit nu are mode. force_shown — este întotdeauna afișat, nu poate fi ascuns. value_required — punct de intrare în secțiune: este întotdeauna afișat, nu poate avea valoare goală (până când nu este selectată o valoare, lista este goală; nu există opțiunea „toate”), resetarea generală nu îl curăță.

Valori:force_shownvalue_required

Exemplu: value_required

date_rangeobject (FilterDateRange)

Perioade predefinite pentru filtrul de dată; limita inferioară este calculată în fusul orar al utilizatorului. value — perioada pentru care corespund valorile curente *_from și *_to; null — perioadă personalizată. default — perioada pe care serverul o setează în cererile fără date: aceasta se aplică la prima încărcare a secțiunii și la resetare. Limita superioară a perioadei este întotdeauna egală cu ziua curentă a utilizatorului, de aceea option nu o conține: nu este necesar să transmiteți *_to pentru o perioadă predefinită, serverul o setează automat. O perioadă mai lungă de un an este tăiată dinspre limita recentă.

valuestring (DateRange) poate fi null

Perioadă de filtrare predefinită după dată. Nu are propriul parametru de interogare: limita inferioară este deja calculată în option și este transmisă în *_from. Limita superioară nu este transmisă nici în răspuns, nici în cerere — este întotdeauna egală cu ziua curentă a utilizatorului și este setată de server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

defaultstring (DateRange) obligatoriu

Perioadă de filtrare predefinită după dată. Nu are propriul parametru de interogare: limita inferioară este deja calculată în option și este transmisă în *_from. Limita superioară nu este transmisă nici în răspuns, nici în cerere — este întotdeauna egală cu ziua curentă a utilizatorului și este setată de server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

typestringobligatoriu

Exemplu: select

modestring (FilterMode)

Cum interfața procesează filtrul; filtrul obișnuit nu are mode. force_shown — este întotdeauna afișat, nu poate fi ascuns. value_required — punct de intrare în secțiune: este întotdeauna afișat, nu poate avea valoare goală (până când nu este selectată o valoare, lista este goală; nu există opțiunea „toate”), resetarea generală nu îl curăță.

Valori:force_shownvalue_required

Exemplu: value_required

optionarray of objectobligatoriu
valuestring (DateRange) obligatoriu

Perioadă de filtrare predefinită după dată. Nu are propriul parametru de interogare: limita inferioară este deja calculată în option și este transmisă în *_from. Limita superioară nu este transmisă nici în răspuns, nici în cerere — este întotdeauna egală cu ziua curentă a utilizatorului și este setată de server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

date_fromstringobligatoriu

Exemplu: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringpoate fi null

Exemplu: 2026-08-01 00:00:00

typestringobligatoriu

Exemplu: date

modestring (FilterMode)

Cum interfața procesează filtrul; filtrul obișnuit nu are mode. force_shown — este întotdeauna afișat, nu poate fi ascuns. value_required — punct de intrare în secțiune: este întotdeauna afișat, nu poate avea valoare goală (până când nu este selectată o valoare, lista este goală; nu există opțiunea „toate”), resetarea generală nu îl curăță.

Valori:force_shownvalue_required

Exemplu: value_required

date_comparison_toobject (FilterDateTo)
valuestringpoate fi null

Exemplu: 2026-08-31 23:59:59

typestringobligatoriu

Exemplu: date

modestring (FilterMode)

Cum interfața procesează filtrul; filtrul obișnuit nu are mode. force_shown — este întotdeauna afișat, nu poate fi ascuns. value_required — punct de intrare în secțiune: este întotdeauna afișat, nu poate avea valoare goală (până când nu este selectată o valoare, lista este goală; nu există opțiunea „toate”), resetarea generală nu îl curăță.

Valori:force_shownvalue_required

Exemplu: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Perioade predefinite pentru filtrul de date fără valoare implicită: default este întotdeauna null.

valuestring (DateRange) poate fi null

Perioadă de filtrare predefinită după dată. Nu are propriul parametru de interogare: limita inferioară este deja calculată în option și este transmisă în *_from. Limita superioară nu este transmisă nici în răspuns, nici în cerere — este întotdeauna egală cu ziua curentă a utilizatorului și este setată de server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

defaultstring (DateRange) poate fi null

Perioadă de filtrare predefinită după dată. Nu are propriul parametru de interogare: limita inferioară este deja calculată în option și este transmisă în *_from. Limita superioară nu este transmisă nici în răspuns, nici în cerere — este întotdeauna egală cu ziua curentă a utilizatorului și este setată de server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

typestringobligatoriu

Exemplu: select

optionarray of objectobligatoriu
valuestring (DateRange) obligatoriu

Perioadă de filtrare predefinită după dată. Nu are propriul parametru de interogare: limita inferioară este deja calculată în option și este transmisă în *_from. Limita superioară nu este transmisă nici în răspuns, nici în cerere — este întotdeauna egală cu ziua curentă a utilizatorului și este setată de server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

date_fromstringobligatoriu

Exemplu: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Exemplu: 8920

typestringobligatoriu

Exemplu: select

optionarray of object
valueintegerobligatoriu

Exemplu: 8920

namestringobligatoriu

Exemplu: Green Basket | Kaliningrad

modestring (FilterMode)

Cum interfața procesează filtrul; filtrul obișnuit nu are mode. force_shown — este întotdeauna afișat, nu poate fi ascuns. value_required — punct de intrare în secțiune: este întotdeauna afișat, nu poate avea valoare goală (până când nu este selectată o valoare, lista este goală; nu există opțiunea „toate”), resetarea generală nu îl curăță.

Valori:force_shownvalue_required

Exemplu: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Exemplu: 8920

typestringobligatoriu

Exemplu: select

optionarray of object
valueintegerobligatoriu

Exemplu: 8920

namestringobligatoriu

Exemplu: Green Basket | Kaliningrad

modestring (FilterMode)

Cum interfața procesează filtrul; filtrul obișnuit nu are mode. force_shown — este întotdeauna afișat, nu poate fi ascuns. value_required — punct de intrare în secțiune: este întotdeauna afișat, nu poate avea valoare goală (până când nu este selectată o valoare, lista este goală; nu există opțiunea „toate”), resetarea generală nu îl curăță.

Valori:force_shownvalue_required

Exemplu: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) obligatoriu

Plăcuță-contor în rândul sumar: numărul de recenzii și ponderea acestora pentru perioada selectată. percent este null dacă nu există nicio recenzie în perioada respectivă. Modificarea față de perioada de comparație nu este transmisă intenționat: numărul de recenzii depinde de trafic, astfel încât creșterea acestuia nu reflectă calitatea.

valueintegerobligatoriu

Exemplu: 96

percentnumber · float

Exemplu: 75

positiveobject (FeedbackAnalyticsCountTile) obligatoriu

Plăcuță-contor în rândul sumar: numărul de recenzii și ponderea acestora pentru perioada selectată. percent este null dacă nu există nicio recenzie în perioada respectivă. Modificarea față de perioada de comparație nu este transmisă intenționat: numărul de recenzii depinde de trafic, astfel încât creșterea acestuia nu reflectă calitatea.

valueintegerobligatoriu

Exemplu: 96

percentnumber · float

Exemplu: 75

negativeobject (FeedbackAnalyticsCountTile) obligatoriu

Plăcuță-contor în rândul sumar: numărul de recenzii și ponderea acestora pentru perioada selectată. percent este null dacă nu există nicio recenzie în perioada respectivă. Modificarea față de perioada de comparație nu este transmisă intenționat: numărul de recenzii depinde de trafic, astfel încât creșterea acestuia nu reflectă calitatea.

valueintegerobligatoriu

Exemplu: 96

percentnumber · float

Exemplu: 75

positive_shareobject (FeedbackAnalyticsShareTile) obligatoriu

Plăcuța cotei în rândul sumar. Spre deosebire de contoare, conține dynamics — modificarea cotei față de perioada de comparație, exprimată în puncte procentuale; aceasta nu depinde de trafic. percent și dynamics sunt null dacă nu există bază de calcul: nu există recenzii pentru perioada respectivă sau pentru perioada de comparație.

valueintegerobligatoriu

Exemplu: 96

percentnumber · float

Exemplu: 75

dynamicsnumber · float

Exemplu: -0.2

pointsarray of object
datetimestringobligatoriu

Începutul intervalului orar în UTC

Exemplu: 2026-09-08 10:00:00

positiveintegerobligatoriu

Exemplu: 3

negativeintegerobligatoriu

Exemplu: 1