API

Iegūt atsauksmju analītiku

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

Atgriež kopsavilkuma flīzes un atsauksmju grafiku par periodu. Katra punkts — viena stunda UTC; tiek atgriezti tikai ne-tukši punkti. Interfeiss pats pārveido laiku lietotāja laika joslā un apvieno stundas dienās. Noklusējuma periods — šodiena. Periods ir ierobežots ar vienu gadu; garāks periods tiek apgriezts no pēdējiem datumiem. Flīze ar daļu satur dynamics — izmaiņas attiecībā pret date_comparison_*. Ja šis periods nav norādīts, pēc noklusējuma tiek ņemts tāda paša garuma periods tieši pirms izvēlētā. Šī noklusējuma vērtība tiek piemērota tikai salīdzinājumam un netiek atgriezta filtriem.

Autorizācija

api-token + language + role

Vaicājuma parametri

date_fromstring

Piemērs: 25/04/2024

date_tostring

Piemērs: 26/04/2024

date_comparison_fromstring

Piemērs: 25/03/2024

date_comparison_tostring

Piemērs: 26/03/2024

chain_idinteger

Piemērs: 1

branch_idinteger

Piemērs: 1

Atbildes

OK

object
statusstringobligāts

Vērtības:successerror

Piemērs: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringvar būt null

Piemērs: 2026-08-01 00:00:00

typestringobligāts

Piemērs: date

modestring (FilterMode)

Kā interfeiss apstrādā filtru; parastam filtram nav mode. force_shown — vienmēr tiek rādīts, nevar paslēpt. value_required — sadaļas ieejas punkts: vienmēr tiek rādīts, nevar būt tukša vērtība (kamēr vērtība nav izvēlēta, saraksts ir tukšs; nav varianta "visi"), kopējā atiestatīšana to neiztīra.

Vērtības:force_shownvalue_required

Piemērs: value_required

date_toobject (FilterDateTo)
valuestringvar būt null

Piemērs: 2026-08-31 23:59:59

typestringobligāts

Piemērs: date

modestring (FilterMode)

Kā interfeiss apstrādā filtru; parastam filtram nav mode. force_shown — vienmēr tiek rādīts, nevar paslēpt. value_required — sadaļas ieejas punkts: vienmēr tiek rādīts, nevar būt tukša vērtība (kamēr vērtība nav izvēlēta, saraksts ir tukšs; nav varianta "visi"), kopējā atiestatīšana to neiztīra.

Vērtības:force_shownvalue_required

Piemērs: value_required

date_rangeobject (FilterDateRange)

Gatavi datuma filtra periodi; apakšējā robeža tiek aprēķināta lietotāja laika joslā. value — periods, kuram atbilst pašreizējie *_from un *_to; null — patvaļīgs periods. default — periods, kuru serveris izmanto pieprasījumā bez datumiem: tas tiek piemērots arī sadaļas pirmajā ielādē un pie atiestatīšanas. Perioda augšējā robeža vienmēr ir vienāda ar lietotāja pašreizējo dienu, tāpēc option to nesatur: gatavam periodam nav jānosūta *_to, serveris to iestata pats. Periods, kas ir garāks par gadu, tiek apgriezts no svaigākās robežas puses.

valuestring (DateRange) var būt null

Gatavs datuma filtra periods. Tam nav sava vaicājuma parametra: apakšējā robeža jau ir aprēķināta option un tiek izmantota kā *_from. Augšējā robeža netiek nodota ne atbildē, ne vaicājumā — tā vienmēr ir vienāda ar lietotāja pašreizējo dienu un tiek noteikta serverī.

Vērtības:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Piemērs: today

defaultstring (DateRange) obligāts

Gatavs datuma filtra periods. Tam nav sava vaicājuma parametra: apakšējā robeža jau ir aprēķināta option un tiek izmantota kā *_from. Augšējā robeža netiek nodota ne atbildē, ne vaicājumā — tā vienmēr ir vienāda ar lietotāja pašreizējo dienu un tiek noteikta serverī.

Vērtības:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Piemērs: today

typestringobligāts

Piemērs: select

modestring (FilterMode)

Kā interfeiss apstrādā filtru; parastam filtram nav mode. force_shown — vienmēr tiek rādīts, nevar paslēpt. value_required — sadaļas ieejas punkts: vienmēr tiek rādīts, nevar būt tukša vērtība (kamēr vērtība nav izvēlēta, saraksts ir tukšs; nav varianta "visi"), kopējā atiestatīšana to neiztīra.

Vērtības:force_shownvalue_required

Piemērs: value_required

optionarray of objectobligāts
valuestring (DateRange) obligāts

Gatavs datuma filtra periods. Tam nav sava vaicājuma parametra: apakšējā robeža jau ir aprēķināta option un tiek izmantota kā *_from. Augšējā robeža netiek nodota ne atbildē, ne vaicājumā — tā vienmēr ir vienāda ar lietotāja pašreizējo dienu un tiek noteikta serverī.

Vērtības:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Piemērs: today

date_fromstringobligāts

Piemērs: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringvar būt null

Piemērs: 2026-08-01 00:00:00

typestringobligāts

Piemērs: date

modestring (FilterMode)

Kā interfeiss apstrādā filtru; parastam filtram nav mode. force_shown — vienmēr tiek rādīts, nevar paslēpt. value_required — sadaļas ieejas punkts: vienmēr tiek rādīts, nevar būt tukša vērtība (kamēr vērtība nav izvēlēta, saraksts ir tukšs; nav varianta "visi"), kopējā atiestatīšana to neiztīra.

Vērtības:force_shownvalue_required

Piemērs: value_required

date_comparison_toobject (FilterDateTo)
valuestringvar būt null

Piemērs: 2026-08-31 23:59:59

typestringobligāts

Piemērs: date

modestring (FilterMode)

Kā interfeiss apstrādā filtru; parastam filtram nav mode. force_shown — vienmēr tiek rādīts, nevar paslēpt. value_required — sadaļas ieejas punkts: vienmēr tiek rādīts, nevar būt tukša vērtība (kamēr vērtība nav izvēlēta, saraksts ir tukšs; nav varianta "visi"), kopējā atiestatīšana to neiztīra.

Vērtības:force_shownvalue_required

Piemērs: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Gatavi datumu filtra periodi bez noklusējuma vērtības: default vienmēr ir null.

valuestring (DateRange) var būt null

Gatavs datuma filtra periods. Tam nav sava vaicājuma parametra: apakšējā robeža jau ir aprēķināta option un tiek izmantota kā *_from. Augšējā robeža netiek nodota ne atbildē, ne vaicājumā — tā vienmēr ir vienāda ar lietotāja pašreizējo dienu un tiek noteikta serverī.

Vērtības:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Piemērs: today

defaultstring (DateRange) var būt null

Gatavs datuma filtra periods. Tam nav sava vaicājuma parametra: apakšējā robeža jau ir aprēķināta option un tiek izmantota kā *_from. Augšējā robeža netiek nodota ne atbildē, ne vaicājumā — tā vienmēr ir vienāda ar lietotāja pašreizējo dienu un tiek noteikta serverī.

Vērtības:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Piemērs: today

typestringobligāts

Piemērs: select

optionarray of objectobligāts
valuestring (DateRange) obligāts

Gatavs datuma filtra periods. Tam nav sava vaicājuma parametra: apakšējā robeža jau ir aprēķināta option un tiek izmantota kā *_from. Augšējā robeža netiek nodota ne atbildē, ne vaicājumā — tā vienmēr ir vienāda ar lietotāja pašreizējo dienu un tiek noteikta serverī.

Vērtības:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Piemērs: today

date_fromstringobligāts

Piemērs: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Piemērs: 8920

typestringobligāts

Piemērs: select

optionarray of object
valueintegerobligāts

Piemērs: 8920

namestringobligāts

Piemērs: Green Basket | Kaliningrad

modestring (FilterMode)

Kā interfeiss apstrādā filtru; parastam filtram nav mode. force_shown — vienmēr tiek rādīts, nevar paslēpt. value_required — sadaļas ieejas punkts: vienmēr tiek rādīts, nevar būt tukša vērtība (kamēr vērtība nav izvēlēta, saraksts ir tukšs; nav varianta "visi"), kopējā atiestatīšana to neiztīra.

Vērtības:force_shownvalue_required

Piemērs: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Piemērs: 8920

typestringobligāts

Piemērs: select

optionarray of object
valueintegerobligāts

Piemērs: 8920

namestringobligāts

Piemērs: Green Basket | Kaliningrad

modestring (FilterMode)

Kā interfeiss apstrādā filtru; parastam filtram nav mode. force_shown — vienmēr tiek rādīts, nevar paslēpt. value_required — sadaļas ieejas punkts: vienmēr tiek rādīts, nevar būt tukša vērtība (kamēr vērtība nav izvēlēta, saraksts ir tukšs; nav varianta "visi"), kopējā atiestatīšana to neiztīra.

Vērtības:force_shownvalue_required

Piemērs: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) obligāts

Skaitītāja flīze kopsavilkuma rindā: atsauksmju skaits un to īpatsvars periodā. percent ir null, ja periodā nav nevienas atsauksmes. Izmaiņas salīdzinājumā ar salīdzināšanas periodu apzināti netiek nodotas: atsauksmju skaits ir atkarīgs no trafika, tāpēc tā pieaugums neliecina par kvalitāti.

valueintegerobligāts

Piemērs: 96

percentnumber · float

Piemērs: 75

positiveobject (FeedbackAnalyticsCountTile) obligāts

Skaitītāja flīze kopsavilkuma rindā: atsauksmju skaits un to īpatsvars periodā. percent ir null, ja periodā nav nevienas atsauksmes. Izmaiņas salīdzinājumā ar salīdzināšanas periodu apzināti netiek nodotas: atsauksmju skaits ir atkarīgs no trafika, tāpēc tā pieaugums neliecina par kvalitāti.

valueintegerobligāts

Piemērs: 96

percentnumber · float

Piemērs: 75

negativeobject (FeedbackAnalyticsCountTile) obligāts

Skaitītāja flīze kopsavilkuma rindā: atsauksmju skaits un to īpatsvars periodā. percent ir null, ja periodā nav nevienas atsauksmes. Izmaiņas salīdzinājumā ar salīdzināšanas periodu apzināti netiek nodotas: atsauksmju skaits ir atkarīgs no trafika, tāpēc tā pieaugums neliecina par kvalitāti.

valueintegerobligāts

Piemērs: 96

percentnumber · float

Piemērs: 75

positive_shareobject (FeedbackAnalyticsShareTile) obligāts

Dalītas vērtības flīze kopsavilkuma rindā. Atšķirībā no skaitītājiem, tā satur dynamics — izmaiņas dalītas vērtības attiecībā pret salīdzināšanas periodu procentpunktos; tas nav atkarīgs no trafika. percent un dynamics ir null, ja nav ar ko dalīt: nav atsauksmju par periodu vai salīdzināšanas periodu.

valueintegerobligāts

Piemērs: 96

percentnumber · float

Piemērs: 75

dynamicsnumber · float

Piemērs: -0.2

pointsarray of object
datetimestringobligāts

Stundas punkta sākums UTC

Piemērs: 2026-09-08 10:00:00

positiveintegerobligāts

Piemērs: 3

negativeintegerobligāts

Piemērs: 1