API

Gauti atsiliepimų analizę

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

Grąžina apibendrintas plyteles ir atsiliepimų grafiką už laikotarpį. Kiekvienas taškas – viena valanda UTC; grąžinami tik neužpildyti taškai. Sąsaja pati konvertuoja laiką į naudotojo laiko juostą ir sujungia valandas į dienas. Numatytoji laikotarpio reikšmė – šiandien. Laikotarpis ribojamas vieneriais metais; ilgesnis laikotarpis apkarpomas nuo paskutinių datų pusės. Plytelėje su dalimi yra dynamics – pokytis lyginant su date_comparison_*. Jei šis laikotarpis nenurodytas, pagal numatytuosius nustatymus imamas tokio pat ilgio laikotarpis tiesiai prieš pasirinktą. Ši numatytoji reikšmė taikoma tik palyginimui ir negrąžinama filtruose.

Autorizacija

api-token + language + role

Užklausos parametrai

date_fromstring

Pavyzdys: 25/04/2024

date_tostring

Pavyzdys: 26/04/2024

date_comparison_fromstring

Pavyzdys: 25/03/2024

date_comparison_tostring

Pavyzdys: 26/03/2024

chain_idinteger

Pavyzdys: 1

branch_idinteger

Pavyzdys: 1

Atsakymai

OK

object
statusstringprivalomas

Reikšmės:successerror

Pavyzdys: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringgali būti null

Pavyzdys: 2026-08-01 00:00:00

typestringprivalomas

Pavyzdys: date

modestring (FilterMode)

Kaip sąsaja apdoroja filtrą; paprastam filtrui mode nėra. force_shown — visada rodomas, paslėpti negalima. value_required — įėjimo taškas į skyrių: visada rodomas, neturi tuščios reikšmės (kol reikšmė nepasirinkta, sąrašas tuščias; varianto „visi“ nėra), bendras atstatymas jo neišvalo.

Reikšmės:force_shownvalue_required

Pavyzdys: value_required

date_toobject (FilterDateTo)
valuestringgali būti null

Pavyzdys: 2026-08-31 23:59:59

typestringprivalomas

Pavyzdys: date

modestring (FilterMode)

Kaip sąsaja apdoroja filtrą; paprastam filtrui mode nėra. force_shown — visada rodomas, paslėpti negalima. value_required — įėjimo taškas į skyrių: visada rodomas, neturi tuščios reikšmės (kol reikšmė nepasirinkta, sąrašas tuščias; varianto „visi“ nėra), bendras atstatymas jo neišvalo.

Reikšmės:force_shownvalue_required

Pavyzdys: value_required

date_rangeobject (FilterDateRange)

Paruošti datos filtro laikotarpiai; apatinė riba apskaičiuojama pagal naudotojo laiko juostą. value — laikotarpis, kuriam atitinka dabartiniai *_from ir *_to; null — pasirinktinis laikotarpis. default — laikotarpis, kurį serveris naudoja užklausoje be datų: jis taip pat taikomas pirmą kartą įkėlus skyrių ir grąžinamas atstatant nustatymus. Viršutinė laikotarpio riba visada lygi dabartinei naudotojo dienai, todėl option jos neturi: perduoti *_to paruoštam laikotarpiui nereikia, serveris ją nustato automatiškai. Laikotarpis, ilgesnis nei metai, nukerpamas nuo naujesnės ribos.

valuestring (DateRange) gali būti null

Paruoštas datos filtro laikotarpis. Neturi atskiro užklausos parametro: apatinė riba jau apskaičiuota ir perduodama per option, įrašoma į *_from. Viršutinė riba neperduodama nei atsakyme, nei užklausoje — ji visada lygi dabartinei naudotojo dienai ir nustatoma serverio.

Reikšmės:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Pavyzdys: today

defaultstring (DateRange) privalomas

Paruoštas datos filtro laikotarpis. Neturi atskiro užklausos parametro: apatinė riba jau apskaičiuota ir perduodama per option, įrašoma į *_from. Viršutinė riba neperduodama nei atsakyme, nei užklausoje — ji visada lygi dabartinei naudotojo dienai ir nustatoma serverio.

Reikšmės:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Pavyzdys: today

typestringprivalomas

Pavyzdys: select

modestring (FilterMode)

Kaip sąsaja apdoroja filtrą; paprastam filtrui mode nėra. force_shown — visada rodomas, paslėpti negalima. value_required — įėjimo taškas į skyrių: visada rodomas, neturi tuščios reikšmės (kol reikšmė nepasirinkta, sąrašas tuščias; varianto „visi“ nėra), bendras atstatymas jo neišvalo.

Reikšmės:force_shownvalue_required

Pavyzdys: value_required

optionarray of objectprivalomas
valuestring (DateRange) privalomas

Paruoštas datos filtro laikotarpis. Neturi atskiro užklausos parametro: apatinė riba jau apskaičiuota ir perduodama per option, įrašoma į *_from. Viršutinė riba neperduodama nei atsakyme, nei užklausoje — ji visada lygi dabartinei naudotojo dienai ir nustatoma serverio.

Reikšmės:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Pavyzdys: today

date_fromstringprivalomas

Pavyzdys: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringgali būti null

Pavyzdys: 2026-08-01 00:00:00

typestringprivalomas

Pavyzdys: date

modestring (FilterMode)

Kaip sąsaja apdoroja filtrą; paprastam filtrui mode nėra. force_shown — visada rodomas, paslėpti negalima. value_required — įėjimo taškas į skyrių: visada rodomas, neturi tuščios reikšmės (kol reikšmė nepasirinkta, sąrašas tuščias; varianto „visi“ nėra), bendras atstatymas jo neišvalo.

Reikšmės:force_shownvalue_required

Pavyzdys: value_required

date_comparison_toobject (FilterDateTo)
valuestringgali būti null

Pavyzdys: 2026-08-31 23:59:59

typestringprivalomas

Pavyzdys: date

modestring (FilterMode)

Kaip sąsaja apdoroja filtrą; paprastam filtrui mode nėra. force_shown — visada rodomas, paslėpti negalima. value_required — įėjimo taškas į skyrių: visada rodomas, neturi tuščios reikšmės (kol reikšmė nepasirinkta, sąrašas tuščias; varianto „visi“ nėra), bendras atstatymas jo neišvalo.

Reikšmės:force_shownvalue_required

Pavyzdys: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Paruošti datų filtro laikotarpiai be numatytosios reikšmės: default visada yra null.

valuestring (DateRange) gali būti null

Paruoštas datos filtro laikotarpis. Neturi atskiro užklausos parametro: apatinė riba jau apskaičiuota ir perduodama per option, įrašoma į *_from. Viršutinė riba neperduodama nei atsakyme, nei užklausoje — ji visada lygi dabartinei naudotojo dienai ir nustatoma serverio.

Reikšmės:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Pavyzdys: today

defaultstring (DateRange) gali būti null

Paruoštas datos filtro laikotarpis. Neturi atskiro užklausos parametro: apatinė riba jau apskaičiuota ir perduodama per option, įrašoma į *_from. Viršutinė riba neperduodama nei atsakyme, nei užklausoje — ji visada lygi dabartinei naudotojo dienai ir nustatoma serverio.

Reikšmės:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Pavyzdys: today

typestringprivalomas

Pavyzdys: select

optionarray of objectprivalomas
valuestring (DateRange) privalomas

Paruoštas datos filtro laikotarpis. Neturi atskiro užklausos parametro: apatinė riba jau apskaičiuota ir perduodama per option, įrašoma į *_from. Viršutinė riba neperduodama nei atsakyme, nei užklausoje — ji visada lygi dabartinei naudotojo dienai ir nustatoma serverio.

Reikšmės:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Pavyzdys: today

date_fromstringprivalomas

Pavyzdys: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Pavyzdys: 8920

typestringprivalomas

Pavyzdys: select

optionarray of object
valueintegerprivalomas

Pavyzdys: 8920

namestringprivalomas

Pavyzdys: Green Basket | Kaliningrad

modestring (FilterMode)

Kaip sąsaja apdoroja filtrą; paprastam filtrui mode nėra. force_shown — visada rodomas, paslėpti negalima. value_required — įėjimo taškas į skyrių: visada rodomas, neturi tuščios reikšmės (kol reikšmė nepasirinkta, sąrašas tuščias; varianto „visi“ nėra), bendras atstatymas jo neišvalo.

Reikšmės:force_shownvalue_required

Pavyzdys: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Pavyzdys: 8920

typestringprivalomas

Pavyzdys: select

optionarray of object
valueintegerprivalomas

Pavyzdys: 8920

namestringprivalomas

Pavyzdys: Green Basket | Kaliningrad

modestring (FilterMode)

Kaip sąsaja apdoroja filtrą; paprastam filtrui mode nėra. force_shown — visada rodomas, paslėpti negalima. value_required — įėjimo taškas į skyrių: visada rodomas, neturi tuščios reikšmės (kol reikšmė nepasirinkta, sąrašas tuščias; varianto „visi“ nėra), bendras atstatymas jo neišvalo.

Reikšmės:force_shownvalue_required

Pavyzdys: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) privalomas

Skaitiklio plytelė suvestinėje eilutėje: atsiliepimų skaičius ir jų dalis per laikotarpį. percent yra null, jei per laikotarpį nėra nė vieno atsiliepimo. Pokytis lyginant su ankstesniu laikotarpiu sąmoningai nesiunčiamas: atsiliepimų skaičius priklauso nuo srauto, todėl jo augimas nieko nesako apie kokybę.

valueintegerprivalomas

Pavyzdys: 96

percentnumber · float

Pavyzdys: 75

positiveobject (FeedbackAnalyticsCountTile) privalomas

Skaitiklio plytelė suvestinėje eilutėje: atsiliepimų skaičius ir jų dalis per laikotarpį. percent yra null, jei per laikotarpį nėra nė vieno atsiliepimo. Pokytis lyginant su ankstesniu laikotarpiu sąmoningai nesiunčiamas: atsiliepimų skaičius priklauso nuo srauto, todėl jo augimas nieko nesako apie kokybę.

valueintegerprivalomas

Pavyzdys: 96

percentnumber · float

Pavyzdys: 75

negativeobject (FeedbackAnalyticsCountTile) privalomas

Skaitiklio plytelė suvestinėje eilutėje: atsiliepimų skaičius ir jų dalis per laikotarpį. percent yra null, jei per laikotarpį nėra nė vieno atsiliepimo. Pokytis lyginant su ankstesniu laikotarpiu sąmoningai nesiunčiamas: atsiliepimų skaičius priklauso nuo srauto, todėl jo augimas nieko nesako apie kokybę.

valueintegerprivalomas

Pavyzdys: 96

percentnumber · float

Pavyzdys: 75

positive_shareobject (FeedbackAnalyticsShareTile) privalomas

Dalies plytelė suvestinėje eilutėje. Skirtingai nei skaitikliai, ji turi dynamics — dalies pokytį lyginant su palyginamuoju laikotarpiu procentiniais punktais; tai nepriklauso nuo srauto. percent ir dynamics yra null, jei nėra ką dalinti: nėra atsiliepimų per laikotarpį arba per palyginamąjį laikotarpį.

valueintegerprivalomas

Pavyzdys: 96

percentnumber · float

Pavyzdys: 75

dynamicsnumber · float

Pavyzdys: -0.2

pointsarray of object
datetimestringprivalomas

Valandos pradžios taškas UTC

Pavyzdys: 2026-09-08 10:00:00

positiveintegerprivalomas

Pavyzdys: 3

negativeintegerprivalomas

Pavyzdys: 1