API

Λήψη ανάλυσης αξιολογήσεων

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

Επιστρέφει συνοπτικά πλακίδια και γράφημα αξιολογήσεων για την περίοδο. Κάθε σημείο αντιστοιχεί σε μία ώρα σε UTC· επιστρέφονται μόνο μη κενά σημεία. Το interface μετατρέπει αυτόματα την ώρα στη ζώνη ώρας του χρήστη και ομαδοποιεί τις ώρες σε ημέρες. Η προεπιλεγμένη περίοδος είναι σήμερα. Η περίοδος περιορίζεται σε ένα έτος· μεγαλύτερη περίοδος περικόπτεται από τις πιο πρόσφατες ημερομηνίες. Το πλακίδιο ποσοστού περιέχει 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)
valuestringμπορεί να είναι null

Παράδειγμα: 2026-08-01 00:00:00

typestringυποχρεωτικό

Παράδειγμα: date

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

date_toobject (FilterDateTo)
valuestringμπορεί να είναι null

Παράδειγμα: 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)
valuestringμπορεί να είναι null

Παράδειγμα: 2026-08-01 00:00:00

typestringυποχρεωτικό

Παράδειγμα: date

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

date_comparison_toobject (FilterDateTo)
valuestringμπορεί να είναι null

Παράδειγμα: 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