API

Mendapatkan analitik ulasan

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

Mengembalikan tile ringkasan dan grafik ulasan untuk periode tertentu. Setiap titik mewakili satu jam dalam UTC; hanya titik yang tidak kosong yang dikembalikan. Antarmuka secara otomatis mengonversi waktu ke zona waktu pengguna dan mengelompokkan jam ke dalam hari. Periode default adalah hari ini. Periode dibatasi maksimal satu tahun; periode yang lebih panjang akan dipotong dari tanggal terbaru. Tile proporsi berisi dynamics — perubahan relatif terhadap date_comparison_*. Jika periode ini tidak ditentukan, secara default digunakan periode dengan durasi yang sama tepat sebelum periode yang dipilih. Nilai default ini hanya berlaku untuk perbandingan dan tidak dikembalikan dalam filter.

Otorisasi

api-token + language + role

Parameter permintaan

date_fromstring

Contoh: 25/04/2024

date_tostring

Contoh: 26/04/2024

date_comparison_fromstring

Contoh: 25/03/2024

date_comparison_tostring

Contoh: 26/03/2024

chain_idinteger

Contoh: 1

branch_idinteger

Contoh: 1

Tanggapan

OK

object
statusstringwajib

Nilai:successerror

Contoh: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringdapat bernilai null

Contoh: 2026-08-01 00:00:00

typestringwajib

Contoh: date

modestring (FilterMode)

Bagaimana antarmuka memproses filter; filter biasa tidak memiliki mode. force_shown — selalu ditampilkan, tidak bisa disembunyikan. value_required — titik masuk ke bagian: selalu ditampilkan, tidak memiliki nilai kosong (selama nilai belum dipilih, daftar kosong; tidak ada opsi "semua"), reset umum tidak menghapusnya.

Nilai:force_shownvalue_required

Contoh: value_required

date_toobject (FilterDateTo)
valuestringdapat bernilai null

Contoh: 2026-08-31 23:59:59

typestringwajib

Contoh: date

modestring (FilterMode)

Bagaimana antarmuka memproses filter; filter biasa tidak memiliki mode. force_shown — selalu ditampilkan, tidak bisa disembunyikan. value_required — titik masuk ke bagian: selalu ditampilkan, tidak memiliki nilai kosong (selama nilai belum dipilih, daftar kosong; tidak ada opsi "semua"), reset umum tidak menghapusnya.

Nilai:force_shownvalue_required

Contoh: value_required

date_rangeobject (FilterDateRange)

Periode filter tanggal yang sudah jadi; batas bawah dihitung berdasarkan zona waktu pengguna. value — periode yang sesuai dengan *_from dan *_to saat ini; null — periode kustom. default — periode yang akan diisi server dalam permintaan tanpa tanggal: juga digunakan saat pertama kali membuka bagian, dan saat reset kembali ke periode ini. Batas atas periode selalu sama dengan hari saat ini pengguna, sehingga option tidak menyertakannya: tidak perlu mengirimkan *_to untuk periode siap pakai, server akan menetapkannya secara otomatis. Periode yang lebih dari satu tahun akan dipotong dari sisi batas terbaru.

valuestring (DateRange) dapat bernilai null

Periode filter tanggal yang sudah siap. Tidak memiliki parameter permintaan sendiri: batas bawah sudah dihitung di option dan dimasukkan ke *_from. Batas atas tidak dikirimkan baik dalam respons maupun permintaan — selalu sama dengan hari ini menurut pengguna dan ditetapkan oleh server.

Nilai:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Contoh: today

defaultstring (DateRange) wajib

Periode filter tanggal yang sudah siap. Tidak memiliki parameter permintaan sendiri: batas bawah sudah dihitung di option dan dimasukkan ke *_from. Batas atas tidak dikirimkan baik dalam respons maupun permintaan — selalu sama dengan hari ini menurut pengguna dan ditetapkan oleh server.

Nilai:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Contoh: today

typestringwajib

Contoh: select

modestring (FilterMode)

Bagaimana antarmuka memproses filter; filter biasa tidak memiliki mode. force_shown — selalu ditampilkan, tidak bisa disembunyikan. value_required — titik masuk ke bagian: selalu ditampilkan, tidak memiliki nilai kosong (selama nilai belum dipilih, daftar kosong; tidak ada opsi "semua"), reset umum tidak menghapusnya.

Nilai:force_shownvalue_required

Contoh: value_required

optionarray of objectwajib
valuestring (DateRange) wajib

Periode filter tanggal yang sudah siap. Tidak memiliki parameter permintaan sendiri: batas bawah sudah dihitung di option dan dimasukkan ke *_from. Batas atas tidak dikirimkan baik dalam respons maupun permintaan — selalu sama dengan hari ini menurut pengguna dan ditetapkan oleh server.

Nilai:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Contoh: today

date_fromstringwajib

Contoh: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringdapat bernilai null

Contoh: 2026-08-01 00:00:00

typestringwajib

Contoh: date

modestring (FilterMode)

Bagaimana antarmuka memproses filter; filter biasa tidak memiliki mode. force_shown — selalu ditampilkan, tidak bisa disembunyikan. value_required — titik masuk ke bagian: selalu ditampilkan, tidak memiliki nilai kosong (selama nilai belum dipilih, daftar kosong; tidak ada opsi "semua"), reset umum tidak menghapusnya.

Nilai:force_shownvalue_required

Contoh: value_required

date_comparison_toobject (FilterDateTo)
valuestringdapat bernilai null

Contoh: 2026-08-31 23:59:59

typestringwajib

Contoh: date

modestring (FilterMode)

Bagaimana antarmuka memproses filter; filter biasa tidak memiliki mode. force_shown — selalu ditampilkan, tidak bisa disembunyikan. value_required — titik masuk ke bagian: selalu ditampilkan, tidak memiliki nilai kosong (selama nilai belum dipilih, daftar kosong; tidak ada opsi "semua"), reset umum tidak menghapusnya.

Nilai:force_shownvalue_required

Contoh: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Periode filter tanggal siap pakai tanpa nilai default: default selalu bernilai null.

valuestring (DateRange) dapat bernilai null

Periode filter tanggal yang sudah siap. Tidak memiliki parameter permintaan sendiri: batas bawah sudah dihitung di option dan dimasukkan ke *_from. Batas atas tidak dikirimkan baik dalam respons maupun permintaan — selalu sama dengan hari ini menurut pengguna dan ditetapkan oleh server.

Nilai:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Contoh: today

defaultstring (DateRange) dapat bernilai null

Periode filter tanggal yang sudah siap. Tidak memiliki parameter permintaan sendiri: batas bawah sudah dihitung di option dan dimasukkan ke *_from. Batas atas tidak dikirimkan baik dalam respons maupun permintaan — selalu sama dengan hari ini menurut pengguna dan ditetapkan oleh server.

Nilai:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Contoh: today

typestringwajib

Contoh: select

optionarray of objectwajib
valuestring (DateRange) wajib

Periode filter tanggal yang sudah siap. Tidak memiliki parameter permintaan sendiri: batas bawah sudah dihitung di option dan dimasukkan ke *_from. Batas atas tidak dikirimkan baik dalam respons maupun permintaan — selalu sama dengan hari ini menurut pengguna dan ditetapkan oleh server.

Nilai:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Contoh: today

date_fromstringwajib

Contoh: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Contoh: 8920

typestringwajib

Contoh: select

optionarray of object
valueintegerwajib

Contoh: 8920

namestringwajib

Contoh: Green Basket | Kaliningrad

modestring (FilterMode)

Bagaimana antarmuka memproses filter; filter biasa tidak memiliki mode. force_shown — selalu ditampilkan, tidak bisa disembunyikan. value_required — titik masuk ke bagian: selalu ditampilkan, tidak memiliki nilai kosong (selama nilai belum dipilih, daftar kosong; tidak ada opsi "semua"), reset umum tidak menghapusnya.

Nilai:force_shownvalue_required

Contoh: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Contoh: 8920

typestringwajib

Contoh: select

optionarray of object
valueintegerwajib

Contoh: 8920

namestringwajib

Contoh: Green Basket | Kaliningrad

modestring (FilterMode)

Bagaimana antarmuka memproses filter; filter biasa tidak memiliki mode. force_shown — selalu ditampilkan, tidak bisa disembunyikan. value_required — titik masuk ke bagian: selalu ditampilkan, tidak memiliki nilai kosong (selama nilai belum dipilih, daftar kosong; tidak ada opsi "semua"), reset umum tidak menghapusnya.

Nilai:force_shownvalue_required

Contoh: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) wajib

Ubin penghitung di baris ringkasan: jumlah ulasan dan persentasenya selama periode. percent bernilai null jika tidak ada ulasan selama periode tersebut. Perubahan relatif terhadap periode pembanding sengaja tidak dikirimkan: jumlah ulasan bergantung pada trafik, sehingga peningkatannya tidak menunjukkan kualitas.

valueintegerwajib

Contoh: 96

percentnumber · float

Contoh: 75

positiveobject (FeedbackAnalyticsCountTile) wajib

Ubin penghitung di baris ringkasan: jumlah ulasan dan persentasenya selama periode. percent bernilai null jika tidak ada ulasan selama periode tersebut. Perubahan relatif terhadap periode pembanding sengaja tidak dikirimkan: jumlah ulasan bergantung pada trafik, sehingga peningkatannya tidak menunjukkan kualitas.

valueintegerwajib

Contoh: 96

percentnumber · float

Contoh: 75

negativeobject (FeedbackAnalyticsCountTile) wajib

Ubin penghitung di baris ringkasan: jumlah ulasan dan persentasenya selama periode. percent bernilai null jika tidak ada ulasan selama periode tersebut. Perubahan relatif terhadap periode pembanding sengaja tidak dikirimkan: jumlah ulasan bergantung pada trafik, sehingga peningkatannya tidak menunjukkan kualitas.

valueintegerwajib

Contoh: 96

percentnumber · float

Contoh: 75

positive_shareobject (FeedbackAnalyticsShareTile) wajib

Ubin berbagi di baris ringkasan. Berbeda dengan penghitung, ini berisi dynamics — perubahan persentase dibandingkan dengan periode pembanding dalam satuan poin persentase; nilainya tidak bergantung pada trafik. percent dan dynamics bernilai null jika tidak ada pembagi: tidak ada ulasan untuk periode ini atau periode pembanding.

valueintegerwajib

Contoh: 96

percentnumber · float

Contoh: 75

dynamicsnumber · float

Contoh: -0.2

pointsarray of object
datetimestringwajib

Awal titik jam dalam UTC

Contoh: 2026-09-08 10:00:00

positiveintegerwajib

Contoh: 3

negativeintegerwajib

Contoh: 1