API

Rəylərin analitikasını əldə et

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

Köhnə dövr üçün ümumi plitkalar və rəylərin qrafiki qaytarılır. Hər bir nöqtə UTC-də bir saatı göstərir; yalnız boş olmayan nöqtələr qaytarılır. İnterfeys vaxtı istifadəçinin saat qurşağına çevirir və saatları günlərə birləşdirir. Standart dövr — bu gündür. Dövr maksimum bir il ilə məhdudlaşdırılıb; daha uzun dövr son tarixlərdən kəsilir. Pay plitkası dynamics sahəsini ehtiva edir — bu, date_comparison_* ilə müqayisədə dəyişiklikdir. Əgər bu dövr göstərilməyibsə, standart olaraq seçilmiş dövrün dərhal əvvəlində olan eyni uzunluqda dövr götürülür. Bu standart dəyər yalnız müqayisə üçün tətbiq olunur və filtrlərdə qaytarılmır.

Avtorizasiya

api-token + language + role

Sorğu parametrləri

date_fromstring

Nümunə: 25/04/2024

date_tostring

Nümunə: 26/04/2024

date_comparison_fromstring

Nümunə: 25/03/2024

date_comparison_tostring

Nümunə: 26/03/2024

chain_idinteger

Nümunə: 1

branch_idinteger

Nümunə: 1

Cavablar

OK

object
statusstringmütləq

Dəyərlər:successerror

Nümunə: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringnull ola bilər

Nümunə: 2026-08-01 00:00:00

typestringmütləq

Nümunə: date

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

date_toobject (FilterDateTo)
valuestringnull ola bilər

Nümunə: 2026-08-31 23:59:59

typestringmütləq

Nümunə: date

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

date_rangeobject (FilterDateRange)

Hazır tarix aralığı filtrləri; aşağı sərhəd istifadəçinin saat qurşağında hesablanır. value — cari *_from və *_to-ya uyğun olan aralıq; null — istənilən aralıq. default — serverin tarixsiz sorğuda təyin etdiyi aralıq: həmçinin bölmə ilk dəfə yüklənəndə və sıfırlama zamanı tətbiq olunur. Aralığın yuxarı sərhədi həmişə istifadəçinin cari gününə bərabərdir, buna görə option onu ehtiva etmir: hazır aralıq üçün *_to göndərmək lazım deyil, server onu özü təyin edir. Bir ildən uzun aralıq yeni sərhəd tərəfindən kəsilir.

valuestring (DateRange) null ola bilər

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

defaultstring (DateRange) mütləq

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

typestringmütləq

Nümunə: select

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

optionarray of objectmütləq
valuestring (DateRange) mütləq

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

date_fromstringmütləq

Nümunə: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringnull ola bilər

Nümunə: 2026-08-01 00:00:00

typestringmütləq

Nümunə: date

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

date_comparison_toobject (FilterDateTo)
valuestringnull ola bilər

Nümunə: 2026-08-31 23:59:59

typestringmütləq

Nümunə: date

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Hazır tarix aralığı filtrləri, standart dəyərsiz: default həmişə null-dır.

valuestring (DateRange) null ola bilər

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

defaultstring (DateRange) null ola bilər

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

typestringmütləq

Nümunə: select

optionarray of objectmütləq
valuestring (DateRange) mütləq

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

date_fromstringmütləq

Nümunə: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Nümunə: 8920

typestringmütləq

Nümunə: select

optionarray of object
valueintegermütləq

Nümunə: 8920

namestringmütləq

Nümunə: Green Basket | Kaliningrad

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Nümunə: 8920

typestringmütləq

Nümunə: select

optionarray of object
valueintegermütləq

Nümunə: 8920

namestringmütləq

Nümunə: Green Basket | Kaliningrad

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) mütləq

Sayğac plitkası xülasə sətrində: dövr ərzində rəylərin sayı və onların payı. percent dövr ərzində heç bir rəy yoxdursa, null olur. Müqayisə dövrünə nisbətən dəyişiklik qəsdən ötürülmür: rəylərin sayı trafikin həcminə bağlıdır, buna görə də onun artımı keyfiyyət barədə heç nə demir.

valueintegermütləq

Nümunə: 96

percentnumber · float

Nümunə: 75

positiveobject (FeedbackAnalyticsCountTile) mütləq

Sayğac plitkası xülasə sətrində: dövr ərzində rəylərin sayı və onların payı. percent dövr ərzində heç bir rəy yoxdursa, null olur. Müqayisə dövrünə nisbətən dəyişiklik qəsdən ötürülmür: rəylərin sayı trafikin həcminə bağlıdır, buna görə də onun artımı keyfiyyət barədə heç nə demir.

valueintegermütləq

Nümunə: 96

percentnumber · float

Nümunə: 75

negativeobject (FeedbackAnalyticsCountTile) mütləq

Sayğac plitkası xülasə sətrində: dövr ərzində rəylərin sayı və onların payı. percent dövr ərzində heç bir rəy yoxdursa, null olur. Müqayisə dövrünə nisbətən dəyişiklik qəsdən ötürülmür: rəylərin sayı trafikin həcminə bağlıdır, buna görə də onun artımı keyfiyyət barədə heç nə demir.

valueintegermütləq

Nümunə: 96

percentnumber · float

Nümunə: 75

positive_shareobject (FeedbackAnalyticsShareTile) mütləq

Sətirdəki pay göstəricisi plitkası. Sayğaclardan fərqli olaraq, burada dynamics — müqayisə dövrünə nisbətən payın dəyişməsi faiz bəndlərində göstərilir; bu göstərici trafikin həcminə bağlı deyil. Əgər bölmək üçün əsas yoxdursa: dövr və ya müqayisə dövründə rəy yoxdursa, percent və dynamics dəyərləri null olur.

valueintegermütləq

Nümunə: 96

percentnumber · float

Nümunə: 75

dynamicsnumber · float

Nümunə: -0.2

pointsarray of object
datetimestringmütləq

Saatlıq nöqtənin başlanğıcı UTC-də

Nümunə: 2026-09-08 10:00:00

positiveintegermütləq

Nümunə: 3

negativeintegermütləq

Nümunə: 1