API

Fikr-mulohazalar tahlilini olish

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

Sarlavha va grafiklar tanlangan davr uchun fikr-mulohazalarni umumlashtirib ko‘rsatadi. Har bir nuqta — UTC bo‘yicha bir soat; faqat bo‘sh bo‘lmagan nuqtalar qaytariladi. Interfeys vaqtni foydalanuvchi vaqt mintaqasiga o‘zi o‘giradi va soatlarni kunlarga birlashtiradi. Standart davr — bugun. Davr bir yil bilan cheklangan; undan uzun davrlar oxirgi sanalardan qisqartiriladi. Ulush sarlavhasida dynamics mavjud — bu date_comparison_* ga nisbatan o‘zgarish. Agar bu davr ko‘rsatilmagan bo‘lsa, standart bo‘lib, tanlangan davrdan oldingi shuncha davom etgan davr olinadi. Bu standart qiymat faqat taqqoslash uchun qo‘llaniladi va filtrlarda qaytarilmaydi.

Avtorizatsiya

api-token + language + role

So‘rov parametrlari

date_fromstring

Misol: 25/04/2024

date_tostring

Misol: 26/04/2024

date_comparison_fromstring

Misol: 25/03/2024

date_comparison_tostring

Misol: 26/03/2024

chain_idinteger

Misol: 1

branch_idinteger

Misol: 1

Javoblar

OK

object
statusstringmajburiy

Qiymatlar:successerror

Misol: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringnull bo‘lishi mumkin

Misol: 2026-08-01 00:00:00

typestringmajburiy

Misol: date

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

date_toobject (FilterDateTo)
valuestringnull bo‘lishi mumkin

Misol: 2026-08-31 23:59:59

typestringmajburiy

Misol: date

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

date_rangeobject (FilterDateRange)

Tayyor sana filtrlash davrlari; pastki chegara foydalanuvchi vaqt mintaqasida hisoblanadi. value — joriy *_from va *_to ga mos keladigan davr; null — ixtiyoriy davr. default — server sanalarsiz so‘rovda avtomatik qo‘llaydigan davr: shu davr bo‘lim birinchi yuklanganda va filtrlash tiklanganda ishlatiladi. Davrning yuqori chegarasi har doim foydalanuvchining joriy kuniga teng, shuning uchun option uni o‘z ichiga olmaydi: tayyor davr uchun *_to uzatish shart emas, server uni o‘zi belgilaydi. Davr bir yildan uzun bo‘lsa, yangi chegara tomonidan qisqartiriladi.

valuestring (DateRange) null bo‘lishi mumkin

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

defaultstring (DateRange) majburiy

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

typestringmajburiy

Misol: select

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

optionarray of objectmajburiy
valuestring (DateRange) majburiy

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

date_fromstringmajburiy

Misol: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringnull bo‘lishi mumkin

Misol: 2026-08-01 00:00:00

typestringmajburiy

Misol: date

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

date_comparison_toobject (FilterDateTo)
valuestringnull bo‘lishi mumkin

Misol: 2026-08-31 23:59:59

typestringmajburiy

Misol: date

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Tayyor sana filtrlash davrlari, standart qiymat yo‘q: default har doim null ga teng.

valuestring (DateRange) null bo‘lishi mumkin

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

defaultstring (DateRange) null bo‘lishi mumkin

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

typestringmajburiy

Misol: select

optionarray of objectmajburiy
valuestring (DateRange) majburiy

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

date_fromstringmajburiy

Misol: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Misol: 8920

typestringmajburiy

Misol: select

optionarray of object
valueintegermajburiy

Misol: 8920

namestringmajburiy

Misol: Green Basket | Kaliningrad

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Misol: 8920

typestringmajburiy

Misol: select

optionarray of object
valueintegermajburiy

Misol: 8920

namestringmajburiy

Misol: Green Basket | Kaliningrad

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) majburiy

Hisoblagich plitkasi: davr mobaynida fikr-mulohazalar soni va ularning ulushi. Agar davrda birorta ham fikr-mulohaza bo‘lmasa, percent qiymati null bo‘ladi. Taqqoslash davriga nisbatan o‘zgarish ataylab uzatilmaydi: fikr-mulohazalar soni trafikga bog‘liq, shuning uchun uning o‘sishi sifat haqida ma’lumot bermaydi.

valueintegermajburiy

Misol: 96

percentnumber · float

Misol: 75

positiveobject (FeedbackAnalyticsCountTile) majburiy

Hisoblagich plitkasi: davr mobaynida fikr-mulohazalar soni va ularning ulushi. Agar davrda birorta ham fikr-mulohaza bo‘lmasa, percent qiymati null bo‘ladi. Taqqoslash davriga nisbatan o‘zgarish ataylab uzatilmaydi: fikr-mulohazalar soni trafikga bog‘liq, shuning uchun uning o‘sishi sifat haqida ma’lumot bermaydi.

valueintegermajburiy

Misol: 96

percentnumber · float

Misol: 75

negativeobject (FeedbackAnalyticsCountTile) majburiy

Hisoblagich plitkasi: davr mobaynida fikr-mulohazalar soni va ularning ulushi. Agar davrda birorta ham fikr-mulohaza bo‘lmasa, percent qiymati null bo‘ladi. Taqqoslash davriga nisbatan o‘zgarish ataylab uzatilmaydi: fikr-mulohazalar soni trafikga bog‘liq, shuning uchun uning o‘sishi sifat haqida ma’lumot bermaydi.

valueintegermajburiy

Misol: 96

percentnumber · float

Misol: 75

positive_shareobject (FeedbackAnalyticsShareTile) majburiy

Sarlavha satridagi ulush plitkasi. Hisoblagichlardan farqli o‘laroq, u dynamics — taqqoslash davriga nisbatan ulush o‘zgarishini foiz punktlarida ko‘rsatadi; bu trafikga bog‘liq emas. Agar bo‘lish uchun asos bo‘lmasa: davr yoki taqqoslash davrida sharhlar bo‘lmasa, percent va dynamics qiymati null bo‘ladi.

valueintegermajburiy

Misol: 96

percentnumber · float

Misol: 75

dynamicsnumber · float

Misol: -0.2

pointsarray of object
datetimestringmajburiy

Soatlik nuqtaning boshlanishi (UTC)

Misol: 2026-09-08 10:00:00

positiveintegermajburiy

Misol: 3

negativeintegermajburiy

Misol: 1