API

Saada tagasiside analüütika

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

Tagastab kokkuvõtlikud plaadid ja tagasiside graafiku perioodi kohta. Iga punkt tähistab ühte tundi UTC-s; tagastatakse ainult mitte-tühjad punktid. Liides teisendab aja kasutaja ajavööndisse ja koondab tunnid päevadesse. Vaikimisi periood on tänane päev. Periood on piiratud ühe aastaga; pikem periood kärbitakse viimaste kuupäevade arvelt. Osakaalu plaadil sisaldab dynamics — muutus võrreldes date_comparison_*. Kui seda perioodi pole määratud, kasutatakse vaikimisi sama pikkust perioodi vahetult enne valitud perioodi. See vaikeväärtus rakendub ainult võrdlusele ega tagastata filtrites.

Autoriseerimine

api-token + language + role

Päringu parameetrid

date_fromstring

Näide: 25/04/2024

date_tostring

Näide: 26/04/2024

date_comparison_fromstring

Näide: 25/03/2024

date_comparison_tostring

Näide: 26/03/2024

chain_idinteger

Näide: 1

branch_idinteger

Näide: 1

Vastused

OK

object
statusstringkohustuslik

Väärtused:successerror

Näide: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringvõib olla null

Näide: 2026-08-01 00:00:00

typestringkohustuslik

Näide: date

modestring (FilterMode)

Kuidas liides töötleb filtrit; tavalisel filtril pole mode. force_shown — alati kuvatud, peita ei saa. value_required — sektsiooni sisenemispunkt: alati kuvatud, ei saa olla tühja väärtust (kuni väärtus pole valitud, loend on tühi; valikut „kõik” pole), üldine lähtestamine seda ei tühjenda.

Väärtused:force_shownvalue_required

Näide: value_required

date_toobject (FilterDateTo)
valuestringvõib olla null

Näide: 2026-08-31 23:59:59

typestringkohustuslik

Näide: date

modestring (FilterMode)

Kuidas liides töötleb filtrit; tavalisel filtril pole mode. force_shown — alati kuvatud, peita ei saa. value_required — sektsiooni sisenemispunkt: alati kuvatud, ei saa olla tühja väärtust (kuni väärtus pole valitud, loend on tühi; valikut „kõik” pole), üldine lähtestamine seda ei tühjenda.

Väärtused:force_shownvalue_required

Näide: value_required

date_rangeobject (FilterDateRange)

Valmis kuupäevafiltri perioodid; alumine piir arvutatakse kasutaja ajavööndi järgi. value — periood, millele vastavad praegused *_from ja *_to; null — suvaline periood. default — periood, mille server lisab päringusse ilma kuupäevadeta: seda kasutatakse ka jaotise esmasel laadimisel ning lähtestamisel. Perioodi ülemine piir on alati kasutaja tänane päev, seetõttu option seda ei sisalda: valmisperioodi puhul pole vaja *_to edastada, server määrab selle ise. Üle aasta pikkune periood kärbitakse uuema piiri poolt.

valuestring (DateRange) võib olla null

Valmis kuupäevafiltri periood. Sellel ei ole oma päringuparameetrit: alumine piir arvutatakse ette ja edastatakse option kaudu ning kasutatakse väljal *_from. Ülemist piiri ei edastata vastuses ega päringus — see on alati võrdne kasutaja jooksva kuupäevaga ja määratakse serveri poolt.

Väärtused:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Näide: today

defaultstring (DateRange) kohustuslik

Valmis kuupäevafiltri periood. Sellel ei ole oma päringuparameetrit: alumine piir arvutatakse ette ja edastatakse option kaudu ning kasutatakse väljal *_from. Ülemist piiri ei edastata vastuses ega päringus — see on alati võrdne kasutaja jooksva kuupäevaga ja määratakse serveri poolt.

Väärtused:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Näide: today

typestringkohustuslik

Näide: select

modestring (FilterMode)

Kuidas liides töötleb filtrit; tavalisel filtril pole mode. force_shown — alati kuvatud, peita ei saa. value_required — sektsiooni sisenemispunkt: alati kuvatud, ei saa olla tühja väärtust (kuni väärtus pole valitud, loend on tühi; valikut „kõik” pole), üldine lähtestamine seda ei tühjenda.

Väärtused:force_shownvalue_required

Näide: value_required

optionarray of objectkohustuslik
valuestring (DateRange) kohustuslik

Valmis kuupäevafiltri periood. Sellel ei ole oma päringuparameetrit: alumine piir arvutatakse ette ja edastatakse option kaudu ning kasutatakse väljal *_from. Ülemist piiri ei edastata vastuses ega päringus — see on alati võrdne kasutaja jooksva kuupäevaga ja määratakse serveri poolt.

Väärtused:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Näide: today

date_fromstringkohustuslik

Näide: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringvõib olla null

Näide: 2026-08-01 00:00:00

typestringkohustuslik

Näide: date

modestring (FilterMode)

Kuidas liides töötleb filtrit; tavalisel filtril pole mode. force_shown — alati kuvatud, peita ei saa. value_required — sektsiooni sisenemispunkt: alati kuvatud, ei saa olla tühja väärtust (kuni väärtus pole valitud, loend on tühi; valikut „kõik” pole), üldine lähtestamine seda ei tühjenda.

Väärtused:force_shownvalue_required

Näide: value_required

date_comparison_toobject (FilterDateTo)
valuestringvõib olla null

Näide: 2026-08-31 23:59:59

typestringkohustuslik

Näide: date

modestring (FilterMode)

Kuidas liides töötleb filtrit; tavalisel filtril pole mode. force_shown — alati kuvatud, peita ei saa. value_required — sektsiooni sisenemispunkt: alati kuvatud, ei saa olla tühja väärtust (kuni väärtus pole valitud, loend on tühi; valikut „kõik” pole), üldine lähtestamine seda ei tühjenda.

Väärtused:force_shownvalue_required

Näide: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Valmis kuupäevavahemiku filtrid ilma vaikimisi väärtuseta: default on alati null.

valuestring (DateRange) võib olla null

Valmis kuupäevafiltri periood. Sellel ei ole oma päringuparameetrit: alumine piir arvutatakse ette ja edastatakse option kaudu ning kasutatakse väljal *_from. Ülemist piiri ei edastata vastuses ega päringus — see on alati võrdne kasutaja jooksva kuupäevaga ja määratakse serveri poolt.

Väärtused:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Näide: today

defaultstring (DateRange) võib olla null

Valmis kuupäevafiltri periood. Sellel ei ole oma päringuparameetrit: alumine piir arvutatakse ette ja edastatakse option kaudu ning kasutatakse väljal *_from. Ülemist piiri ei edastata vastuses ega päringus — see on alati võrdne kasutaja jooksva kuupäevaga ja määratakse serveri poolt.

Väärtused:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Näide: today

typestringkohustuslik

Näide: select

optionarray of objectkohustuslik
valuestring (DateRange) kohustuslik

Valmis kuupäevafiltri periood. Sellel ei ole oma päringuparameetrit: alumine piir arvutatakse ette ja edastatakse option kaudu ning kasutatakse väljal *_from. Ülemist piiri ei edastata vastuses ega päringus — see on alati võrdne kasutaja jooksva kuupäevaga ja määratakse serveri poolt.

Väärtused:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Näide: today

date_fromstringkohustuslik

Näide: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Näide: 8920

typestringkohustuslik

Näide: select

optionarray of object
valueintegerkohustuslik

Näide: 8920

namestringkohustuslik

Näide: Green Basket | Kaliningrad

modestring (FilterMode)

Kuidas liides töötleb filtrit; tavalisel filtril pole mode. force_shown — alati kuvatud, peita ei saa. value_required — sektsiooni sisenemispunkt: alati kuvatud, ei saa olla tühja väärtust (kuni väärtus pole valitud, loend on tühi; valikut „kõik” pole), üldine lähtestamine seda ei tühjenda.

Väärtused:force_shownvalue_required

Näide: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Näide: 8920

typestringkohustuslik

Näide: select

optionarray of object
valueintegerkohustuslik

Näide: 8920

namestringkohustuslik

Näide: Green Basket | Kaliningrad

modestring (FilterMode)

Kuidas liides töötleb filtrit; tavalisel filtril pole mode. force_shown — alati kuvatud, peita ei saa. value_required — sektsiooni sisenemispunkt: alati kuvatud, ei saa olla tühja väärtust (kuni väärtus pole valitud, loend on tühi; valikut „kõik” pole), üldine lähtestamine seda ei tühjenda.

Väärtused:force_shownvalue_required

Näide: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) kohustuslik

Kokkuvõttereal olev loendur: arvustuste arv ja nende osakaal perioodil. percent on null, kui perioodil pole ühtegi arvustust. Võrdlusperioodi muutust ei edastata meelega: arvustuste arv sõltub liiklusest, seega selle kasv ei näita kvaliteeti.

valueintegerkohustuslik

Näide: 96

percentnumber · float

Näide: 75

positiveobject (FeedbackAnalyticsCountTile) kohustuslik

Kokkuvõttereal olev loendur: arvustuste arv ja nende osakaal perioodil. percent on null, kui perioodil pole ühtegi arvustust. Võrdlusperioodi muutust ei edastata meelega: arvustuste arv sõltub liiklusest, seega selle kasv ei näita kvaliteeti.

valueintegerkohustuslik

Näide: 96

percentnumber · float

Näide: 75

negativeobject (FeedbackAnalyticsCountTile) kohustuslik

Kokkuvõttereal olev loendur: arvustuste arv ja nende osakaal perioodil. percent on null, kui perioodil pole ühtegi arvustust. Võrdlusperioodi muutust ei edastata meelega: arvustuste arv sõltub liiklusest, seega selle kasv ei näita kvaliteeti.

valueintegerkohustuslik

Näide: 96

percentnumber · float

Näide: 75

positive_shareobject (FeedbackAnalyticsShareTile) kohustuslik

Osakaalise reatähe. Erinevalt loenduritest sisaldab see dynamics — osakaalu muutus võrreldes võrdlusperioodiga protsendipunktides; see ei sõltu liiklusest. percent ja dynamics on null, kui pole millega võrrelda: puuduvad tagasisided nii perioodil kui ka võrdlusperioodil.

valueintegerkohustuslik

Näide: 96

percentnumber · float

Näide: 75

dynamicsnumber · float

Näide: -0.2

pointsarray of object
datetimestringkohustuslik

Tunnipunkti algus UTC-s

Näide: 2026-09-08 10:00:00

positiveintegerkohustuslik

Näide: 3

negativeintegerkohustuslik

Näide: 1