API

Пікірлер аналитикасын алу

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

Сводтық плиткалар мен пікірлер графигін көрсетілген кезең үшін қайтарады. Әрбір нүкте — UTC бойынша бір сағат; тек бос емес нүктелер қайтарылады. Интерфейс уақытты пайдаланушының уақыт белдеуіне аударады және сағаттарды күндерге біріктіреді. Әдепкі кезең — бүгін. Кезең бір жылмен шектелген; ұзағырақ кезең соңғы күндерден қысқартылады. Үлес плиткасында dynamics бар — date_comparison_* қатысты өзгеріс. Егер бұл кезең көрсетілмесе, әдепкі бойынша таңдалған кезеңнен бұрын дәл сондай ұзындықтағы кезең алынады. Бұл әдепкі мән тек салыстыру үшін қолданылады және сүзгілерде қайтарылмайды.

Авторизация

api-token + language + role

Сұраныс параметрлері

date_fromstring

Мысал: 25/04/2024

date_tostring

Мысал: 26/04/2024

date_comparison_fromstring

Мысал: 25/03/2024

date_comparison_tostring

Мысал: 26/03/2024

chain_idinteger

Мысал: 1

branch_idinteger

Мысал: 1

Жауаптар

OK

object
statusstringміндетті

Мәндер:successerror

Мысал: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringnull мәнін қабылдай алады

Мысал: 2026-08-01 00:00:00

typestringміндетті

Мысал: date

modestring (FilterMode)

Интерфейс сүзгіні қалай өңдейді; кәдімгі сүзгіде mode жоқ. force_shown — әрқашан көрсетіледі, жасыруға болмайды. value_required — бөлімге кіру нүктесі: әрқашан көрсетіледі, бос мәні болмайды (мән таңдалмағанша, тізім бос; «барлығы» нұсқасы жоқ), жалпы тазарту оны өшірмейді.

Мәндер:force_shownvalue_required

Мысал: value_required

date_toobject (FilterDateTo)
valuestringnull мәнін қабылдай алады

Мысал: 2026-08-31 23:59:59

typestringміндетті

Мысал: date

modestring (FilterMode)

Интерфейс сүзгіні қалай өңдейді; кәдімгі сүзгіде mode жоқ. force_shown — әрқашан көрсетіледі, жасыруға болмайды. value_required — бөлімге кіру нүктесі: әрқашан көрсетіледі, бос мәні болмайды (мән таңдалмағанша, тізім бос; «барлығы» нұсқасы жоқ), жалпы тазарту оны өшірмейді.

Мәндер:force_shownvalue_required

Мысал: value_required

date_rangeobject (FilterDateRange)

Дайын күндер бойынша сүзгілеу кезеңдері; төменгі шегі пайдаланушының уақыт белдеуінде есептеледі. value — ағымдағы *_from және *_to сәйкес келетін кезең; null — еркін кезең. default — сервер күндерсіз сұраныста қолданатын кезең: бұл кезең бөлім алғаш жүктелгенде және қалпына келтіру кезінде қолданылады. Кезеңнің жоғарғы шегі әрқашан пайдаланушының ағымдағы күніне тең, сондықтан option оны қамтымайды: дайын кезең үшін *_to жіберудің қажеті жоқ, сервер оны өзі орнатады. Бір жылдан ұзақ кезең жаңа шегінен қысқартылады.

valuestring (DateRange) null мәнін қабылдай алады

Дайын күн бойынша сүзгі кезеңі. Оның жеке сұраныс параметрі жоқ: төменгі шегі есептелген түрде option ішінде келеді және *_from орнына қойылады. Жоғарғы шегі жауапта да, сұраныста да берілмейді — ол әрқашан пайдаланушының ағымдағы күніне тең және сервер арқылы орнатылады.

Мәндер:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Мысал: today

defaultstring (DateRange) міндетті

Дайын күн бойынша сүзгі кезеңі. Оның жеке сұраныс параметрі жоқ: төменгі шегі есептелген түрде option ішінде келеді және *_from орнына қойылады. Жоғарғы шегі жауапта да, сұраныста да берілмейді — ол әрқашан пайдаланушының ағымдағы күніне тең және сервер арқылы орнатылады.

Мәндер:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Мысал: today

typestringміндетті

Мысал: select

modestring (FilterMode)

Интерфейс сүзгіні қалай өңдейді; кәдімгі сүзгіде mode жоқ. force_shown — әрқашан көрсетіледі, жасыруға болмайды. value_required — бөлімге кіру нүктесі: әрқашан көрсетіледі, бос мәні болмайды (мән таңдалмағанша, тізім бос; «барлығы» нұсқасы жоқ), жалпы тазарту оны өшірмейді.

Мәндер:force_shownvalue_required

Мысал: value_required

optionarray of objectміндетті
valuestring (DateRange) міндетті

Дайын күн бойынша сүзгі кезеңі. Оның жеке сұраныс параметрі жоқ: төменгі шегі есептелген түрде option ішінде келеді және *_from орнына қойылады. Жоғарғы шегі жауапта да, сұраныста да берілмейді — ол әрқашан пайдаланушының ағымдағы күніне тең және сервер арқылы орнатылады.

Мәндер:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Мысал: today

date_fromstringміндетті

Мысал: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringnull мәнін қабылдай алады

Мысал: 2026-08-01 00:00:00

typestringміндетті

Мысал: date

modestring (FilterMode)

Интерфейс сүзгіні қалай өңдейді; кәдімгі сүзгіде mode жоқ. force_shown — әрқашан көрсетіледі, жасыруға болмайды. value_required — бөлімге кіру нүктесі: әрқашан көрсетіледі, бос мәні болмайды (мән таңдалмағанша, тізім бос; «барлығы» нұсқасы жоқ), жалпы тазарту оны өшірмейді.

Мәндер:force_shownvalue_required

Мысал: value_required

date_comparison_toobject (FilterDateTo)
valuestringnull мәнін қабылдай алады

Мысал: 2026-08-31 23:59:59

typestringміндетті

Мысал: date

modestring (FilterMode)

Интерфейс сүзгіні қалай өңдейді; кәдімгі сүзгіде mode жоқ. force_shown — әрқашан көрсетіледі, жасыруға болмайды. value_required — бөлімге кіру нүктесі: әрқашан көрсетіледі, бос мәні болмайды (мән таңдалмағанша, тізім бос; «барлығы» нұсқасы жоқ), жалпы тазарту оны өшірмейді.

Мәндер:force_shownvalue_required

Мысал: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Дайын күндер ауқымының фильтрлері әдепкі мәнсіз: default әрқашан null мәніне тең.

valuestring (DateRange) null мәнін қабылдай алады

Дайын күн бойынша сүзгі кезеңі. Оның жеке сұраныс параметрі жоқ: төменгі шегі есептелген түрде option ішінде келеді және *_from орнына қойылады. Жоғарғы шегі жауапта да, сұраныста да берілмейді — ол әрқашан пайдаланушының ағымдағы күніне тең және сервер арқылы орнатылады.

Мәндер:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Мысал: today

defaultstring (DateRange) null мәнін қабылдай алады

Дайын күн бойынша сүзгі кезеңі. Оның жеке сұраныс параметрі жоқ: төменгі шегі есептелген түрде option ішінде келеді және *_from орнына қойылады. Жоғарғы шегі жауапта да, сұраныста да берілмейді — ол әрқашан пайдаланушының ағымдағы күніне тең және сервер арқылы орнатылады.

Мәндер:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Мысал: today

typestringміндетті

Мысал: select

optionarray of objectміндетті
valuestring (DateRange) міндетті

Дайын күн бойынша сүзгі кезеңі. Оның жеке сұраныс параметрі жоқ: төменгі шегі есептелген түрде option ішінде келеді және *_from орнына қойылады. Жоғарғы шегі жауапта да, сұраныста да берілмейді — ол әрқашан пайдаланушының ағымдағы күніне тең және сервер арқылы орнатылады.

Мәндер:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Мысал: today

date_fromstringміндетті

Мысал: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Мысал: 8920

typestringміндетті

Мысал: select

optionarray of object
valueintegerміндетті

Мысал: 8920

namestringміндетті

Мысал: Green Basket | Kaliningrad

modestring (FilterMode)

Интерфейс сүзгіні қалай өңдейді; кәдімгі сүзгіде mode жоқ. force_shown — әрқашан көрсетіледі, жасыруға болмайды. value_required — бөлімге кіру нүктесі: әрқашан көрсетіледі, бос мәні болмайды (мән таңдалмағанша, тізім бос; «барлығы» нұсқасы жоқ), жалпы тазарту оны өшірмейді.

Мәндер:force_shownvalue_required

Мысал: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Мысал: 8920

typestringміндетті

Мысал: select

optionarray of object
valueintegerміндетті

Мысал: 8920

namestringміндетті

Мысал: Green Basket | Kaliningrad

modestring (FilterMode)

Интерфейс сүзгіні қалай өңдейді; кәдімгі сүзгіде mode жоқ. force_shown — әрқашан көрсетіледі, жасыруға болмайды. value_required — бөлімге кіру нүктесі: әрқашан көрсетіледі, бос мәні болмайды (мән таңдалмағанша, тізім бос; «барлығы» нұсқасы жоқ), жалпы тазарту оны өшірмейді.

Мәндер:force_shownvalue_required

Мысал: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) міндетті

Сводтық жолдағы есептегіш-плитка: кезең ішіндегі пікірлер саны және олардың үлесі. Егер кезеңде бірде-бір пікір болмаса, percent мәні null болады. Салыстыру кезеңіне қатысты өзгеріс әдейі берілмейді: пікірлер саны трафикке байланысты, сондықтан оның өсуі сапа туралы ақпарат бермейді.

valueintegerміндетті

Мысал: 96

percentnumber · float

Мысал: 75

positiveobject (FeedbackAnalyticsCountTile) міндетті

Сводтық жолдағы есептегіш-плитка: кезең ішіндегі пікірлер саны және олардың үлесі. Егер кезеңде бірде-бір пікір болмаса, percent мәні null болады. Салыстыру кезеңіне қатысты өзгеріс әдейі берілмейді: пікірлер саны трафикке байланысты, сондықтан оның өсуі сапа туралы ақпарат бермейді.

valueintegerміндетті

Мысал: 96

percentnumber · float

Мысал: 75

negativeobject (FeedbackAnalyticsCountTile) міндетті

Сводтық жолдағы есептегіш-плитка: кезең ішіндегі пікірлер саны және олардың үлесі. Егер кезеңде бірде-бір пікір болмаса, percent мәні null болады. Салыстыру кезеңіне қатысты өзгеріс әдейі берілмейді: пікірлер саны трафикке байланысты, сондықтан оның өсуі сапа туралы ақпарат бермейді.

valueintegerміндетті

Мысал: 96

percentnumber · float

Мысал: 75

positive_shareobject (FeedbackAnalyticsShareTile) міндетті

Сводтық жолдағы үлес плиткасы. Санауыштардан айырмашылығы, мұнда dynamics — салыстыру кезеңіне қатысты үлестің пайыздық пункттердегі өзгерісі; бұл трафикке тәуелді емес. Егер бөлуге негіз жоқ болса: кезеңде немесе салыстыру кезеңінде пікірлер болмаса, percent және dynamics мәндері null болады.

valueintegerміндетті

Мысал: 96

percentnumber · float

Мысал: 75

dynamicsnumber · float

Мысал: -0.2

pointsarray of object
datetimestringміндетті

UTC уақыты бойынша сағаттық нүктенің басталуы

Мысал: 2026-09-08 10:00:00

positiveintegerміндетті

Мысал: 3

negativeintegerміндетті

Мысал: 1