API

Ottenere l'analisi dei feedback

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

Restituisce i riquadri riepilogativi e il grafico dei feedback per il periodo specificato. Ogni punto rappresenta un'ora in UTC; vengono restituite solo le ore con dati. L'interfaccia converte automaticamente l'orario nel fuso orario dell'utente e raggruppa le ore per giorno. Il periodo predefinito è oggi. Il periodo è limitato a un anno; se il periodo richiesto è più lungo, viene troncato dalle date più recenti. Il riquadro della quota contiene dynamics — la variazione rispetto a date_comparison_*. Se questo periodo non è specificato, per impostazione predefinita viene utilizzato un periodo della stessa durata immediatamente precedente a quello selezionato. Questo valore predefinito si applica solo al confronto e non viene restituito nei filtri.

Autorizzazione

api-token + language + role

Parametri della richiesta

date_fromstring

Esempio: 25/04/2024

date_tostring

Esempio: 26/04/2024

date_comparison_fromstring

Esempio: 25/03/2024

date_comparison_tostring

Esempio: 26/03/2024

chain_idinteger

Esempio: 1

branch_idinteger

Esempio: 1

Risposte

OK

object
statusstringobbligatorio

Valori:successerror

Esempio: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringpuò essere nullo

Esempio: 2026-08-01 00:00:00

typestringobbligatorio

Esempio: date

modestring (FilterMode)

Come l'interfaccia gestisce il filtro; un filtro normale non ha mode.
force_shown — sempre visibile, non può essere nascosto.
value_required — punto di ingresso nella sezione: sempre visibile, non può avere valore vuoto (finché non viene selezionato un valore, la lista è vuota; non esiste l'opzione "tutti"), il reset generale non lo azzera.

Valori:force_shownvalue_required

Esempio: value_required

date_toobject (FilterDateTo)
valuestringpuò essere nullo

Esempio: 2026-08-31 23:59:59

typestringobbligatorio

Esempio: date

modestring (FilterMode)

Come l'interfaccia gestisce il filtro; un filtro normale non ha mode.
force_shown — sempre visibile, non può essere nascosto.
value_required — punto di ingresso nella sezione: sempre visibile, non può avere valore vuoto (finché non viene selezionato un valore, la lista è vuota; non esiste l'opzione "tutti"), il reset generale non lo azzera.

Valori:force_shownvalue_required

Esempio: value_required

date_rangeobject (FilterDateRange)

Periodi predefiniti per il filtro data; il limite inferiore è calcolato nel fuso orario dell’utente. value indica il periodo corrispondente agli attuali *_from e *_to; null indica un periodo personalizzato. default è il periodo che il server inserisce nella richiesta senza date: viene applicato al primo caricamento della sezione e al reset. Il limite superiore del periodo corrisponde sempre al giorno attuale dell’utente, quindi option non lo include: non è necessario trasmettere *_to per un periodo predefinito, il server lo imposta automaticamente. Un periodo superiore a un anno viene troncato dal lato più recente.

valuestring (DateRange) può essere nullo

Periodo di filtro data predefinito. Non ha un proprio parametro di richiesta: il limite inferiore viene già calcolato in option e inserito in *_from. Il limite superiore non viene trasmesso né nella risposta né nella richiesta: è sempre uguale al giorno corrente dell’utente e viene impostato dal server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Esempio: today

defaultstring (DateRange) obbligatorio

Periodo di filtro data predefinito. Non ha un proprio parametro di richiesta: il limite inferiore viene già calcolato in option e inserito in *_from. Il limite superiore non viene trasmesso né nella risposta né nella richiesta: è sempre uguale al giorno corrente dell’utente e viene impostato dal server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Esempio: today

typestringobbligatorio

Esempio: select

modestring (FilterMode)

Come l'interfaccia gestisce il filtro; un filtro normale non ha mode.
force_shown — sempre visibile, non può essere nascosto.
value_required — punto di ingresso nella sezione: sempre visibile, non può avere valore vuoto (finché non viene selezionato un valore, la lista è vuota; non esiste l'opzione "tutti"), il reset generale non lo azzera.

Valori:force_shownvalue_required

Esempio: value_required

optionarray of objectobbligatorio
valuestring (DateRange) obbligatorio

Periodo di filtro data predefinito. Non ha un proprio parametro di richiesta: il limite inferiore viene già calcolato in option e inserito in *_from. Il limite superiore non viene trasmesso né nella risposta né nella richiesta: è sempre uguale al giorno corrente dell’utente e viene impostato dal server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Esempio: today

date_fromstringobbligatorio

Esempio: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringpuò essere nullo

Esempio: 2026-08-01 00:00:00

typestringobbligatorio

Esempio: date

modestring (FilterMode)

Come l'interfaccia gestisce il filtro; un filtro normale non ha mode.
force_shown — sempre visibile, non può essere nascosto.
value_required — punto di ingresso nella sezione: sempre visibile, non può avere valore vuoto (finché non viene selezionato un valore, la lista è vuota; non esiste l'opzione "tutti"), il reset generale non lo azzera.

Valori:force_shownvalue_required

Esempio: value_required

date_comparison_toobject (FilterDateTo)
valuestringpuò essere nullo

Esempio: 2026-08-31 23:59:59

typestringobbligatorio

Esempio: date

modestring (FilterMode)

Come l'interfaccia gestisce il filtro; un filtro normale non ha mode.
force_shown — sempre visibile, non può essere nascosto.
value_required — punto di ingresso nella sezione: sempre visibile, non può avere valore vuoto (finché non viene selezionato un valore, la lista è vuota; non esiste l'opzione "tutti"), il reset generale non lo azzera.

Valori:force_shownvalue_required

Esempio: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Periodi predefiniti per il filtro delle date senza valore predefinito: default è sempre uguale a null.

valuestring (DateRange) può essere nullo

Periodo di filtro data predefinito. Non ha un proprio parametro di richiesta: il limite inferiore viene già calcolato in option e inserito in *_from. Il limite superiore non viene trasmesso né nella risposta né nella richiesta: è sempre uguale al giorno corrente dell’utente e viene impostato dal server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Esempio: today

defaultstring (DateRange) può essere nullo

Periodo di filtro data predefinito. Non ha un proprio parametro di richiesta: il limite inferiore viene già calcolato in option e inserito in *_from. Il limite superiore non viene trasmesso né nella risposta né nella richiesta: è sempre uguale al giorno corrente dell’utente e viene impostato dal server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Esempio: today

typestringobbligatorio

Esempio: select

optionarray of objectobbligatorio
valuestring (DateRange) obbligatorio

Periodo di filtro data predefinito. Non ha un proprio parametro di richiesta: il limite inferiore viene già calcolato in option e inserito in *_from. Il limite superiore non viene trasmesso né nella risposta né nella richiesta: è sempre uguale al giorno corrente dell’utente e viene impostato dal server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Esempio: today

date_fromstringobbligatorio

Esempio: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Esempio: 8920

typestringobbligatorio

Esempio: select

optionarray of object
valueintegerobbligatorio

Esempio: 8920

namestringobbligatorio

Esempio: Green Basket | Kaliningrad

modestring (FilterMode)

Come l'interfaccia gestisce il filtro; un filtro normale non ha mode.
force_shown — sempre visibile, non può essere nascosto.
value_required — punto di ingresso nella sezione: sempre visibile, non può avere valore vuoto (finché non viene selezionato un valore, la lista è vuota; non esiste l'opzione "tutti"), il reset generale non lo azzera.

Valori:force_shownvalue_required

Esempio: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Esempio: 8920

typestringobbligatorio

Esempio: select

optionarray of object
valueintegerobbligatorio

Esempio: 8920

namestringobbligatorio

Esempio: Green Basket | Kaliningrad

modestring (FilterMode)

Come l'interfaccia gestisce il filtro; un filtro normale non ha mode.
force_shown — sempre visibile, non può essere nascosto.
value_required — punto di ingresso nella sezione: sempre visibile, non può avere valore vuoto (finché non viene selezionato un valore, la lista è vuota; non esiste l'opzione "tutti"), il reset generale non lo azzera.

Valori:force_shownvalue_required

Esempio: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) obbligatorio

Riquadro contatore nella riga di riepilogo: numero di recensioni e loro percentuale per il periodo. percent è null se non ci sono recensioni nel periodo. La variazione rispetto al periodo di confronto non viene fornita intenzionalmente: il numero di recensioni dipende dal traffico, quindi il suo aumento non indica la qualità.

valueintegerobbligatorio

Esempio: 96

percentnumber · float

Esempio: 75

positiveobject (FeedbackAnalyticsCountTile) obbligatorio

Riquadro contatore nella riga di riepilogo: numero di recensioni e loro percentuale per il periodo. percent è null se non ci sono recensioni nel periodo. La variazione rispetto al periodo di confronto non viene fornita intenzionalmente: il numero di recensioni dipende dal traffico, quindi il suo aumento non indica la qualità.

valueintegerobbligatorio

Esempio: 96

percentnumber · float

Esempio: 75

negativeobject (FeedbackAnalyticsCountTile) obbligatorio

Riquadro contatore nella riga di riepilogo: numero di recensioni e loro percentuale per il periodo. percent è null se non ci sono recensioni nel periodo. La variazione rispetto al periodo di confronto non viene fornita intenzionalmente: il numero di recensioni dipende dal traffico, quindi il suo aumento non indica la qualità.

valueintegerobbligatorio

Esempio: 96

percentnumber · float

Esempio: 75

positive_shareobject (FeedbackAnalyticsShareTile) obbligatorio

Riquadro della quota nella riga di riepilogo. A differenza dei contatori, contiene dynamics — la variazione della quota rispetto al periodo di confronto in punti percentuali; non dipende dal traffico. percent e dynamics sono impostati su null se non c'è nulla da confrontare: nessuna recensione per il periodo o per il periodo di confronto.

valueintegerobbligatorio

Esempio: 96

percentnumber · float

Esempio: 75

dynamicsnumber · float

Esempio: -0.2

pointsarray of object
datetimestringobbligatorio

Inizio dell'intervallo orario in UTC

Esempio: 2026-09-08 10:00:00

positiveintegerobbligatorio

Esempio: 3

negativeintegerobbligatorio

Esempio: 1