API

Geri bildirim analizini al

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

Özet kutucukları ve dönem içindeki geri bildirim grafiğini döndürür. Her nokta, UTC'de bir saati temsil eder; yalnızca boş olmayan noktalar döndürülür. Arayüz, zamanı kullanıcının saat dilimine çevirir ve saatleri günlere toplar. Varsayılan dönem bugündür. Dönem bir yıl ile sınırlıdır; daha uzun dönemler, en son tarihlerden itibaren kesilir. Pay kutucuğu dynamics içerir — date_comparison_* ile karşılaştırmaya göre değişim. Bu dönem belirtilmezse, varsayılan olarak seçilen dönemin hemen öncesindeki aynı uzunluktaki dönem alınır. Bu varsayılan değer yalnızca karşılaştırma için uygulanır ve filtrelerde döndürülmez.

Yetkilendirme

api-token + language + role

Sorgu parametreleri

date_fromstring

Örnek: 25/04/2024

date_tostring

Örnek: 26/04/2024

date_comparison_fromstring

Örnek: 25/03/2024

date_comparison_tostring

Örnek: 26/03/2024

chain_idinteger

Örnek: 1

branch_idinteger

Örnek: 1

Yanıtlar

OK

object
statusstringzorunlu

Değerler:successerror

Örnek: success

dataobject
filtersobject
date_fromobject (FilterDateFrom)
valuestringnull olabilir

Örnek: 2026-08-01 00:00:00

typestringzorunlu

Örnek: date

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

date_toobject (FilterDateTo)
valuestringnull olabilir

Örnek: 2026-08-31 23:59:59

typestringzorunlu

Örnek: date

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

date_rangeobject (FilterDateRange)

Hazır tarih filtre dönemleri; alt sınır, kullanıcının saat diliminde hesaplanır. value — mevcut *_from ve *_to ile eşleşen dönem; null — özel dönem. default — sunucunun tarih belirtilmeyen istekte kullandığı dönemdir: ayrıca bölüm ilk yüklendiğinde ve sıfırlama yapıldığında da uygulanır. Dönemin üst sınırı her zaman kullanıcının bugünkü tarihine eşittir, bu nedenle option bunu içermez: hazır dönem için *_to göndermeye gerek yoktur, sunucu bunu otomatik olarak ayarlar. Bir yıldan uzun dönemler, yeni tarihe yakın taraftan kesilir.

valuestring (DateRange) null olabilir

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

defaultstring (DateRange) zorunlu

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

typestringzorunlu

Örnek: select

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

optionarray of objectzorunlu
valuestring (DateRange) zorunlu

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

date_fromstringzorunlu

Örnek: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringnull olabilir

Örnek: 2026-08-01 00:00:00

typestringzorunlu

Örnek: date

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

date_comparison_toobject (FilterDateTo)
valuestringnull olabilir

Örnek: 2026-08-31 23:59:59

typestringzorunlu

Örnek: date

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Hazır tarih aralığı filtreleri, varsayılan değer olmadan: default her zaman null'dır.

valuestring (DateRange) null olabilir

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

defaultstring (DateRange) null olabilir

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

typestringzorunlu

Örnek: select

optionarray of objectzorunlu
valuestring (DateRange) zorunlu

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

date_fromstringzorunlu

Örnek: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Örnek: 8920

typestringzorunlu

Örnek: select

optionarray of object
valueintegerzorunlu

Örnek: 8920

namestringzorunlu

Örnek: Green Basket | Kaliningrad

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Örnek: 8920

typestringzorunlu

Örnek: select

optionarray of object
valueintegerzorunlu

Örnek: 8920

namestringzorunlu

Örnek: Green Basket | Kaliningrad

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

tilesobject
totalobject (FeedbackAnalyticsCountTile) zorunlu

Özet satırında sayaç kutusu: dönem içindeki yorum sayısı ve oranı. Dönem içinde hiç yorum yoksa percent değeri null olur. Karşılaştırma dönemine göre değişiklik kasıtlı olarak iletilmez: yorum sayısı trafiğe bağlıdır, bu nedenle artışı kalite hakkında bilgi vermez.

valueintegerzorunlu

Örnek: 96

percentnumber · float

Örnek: 75

positiveobject (FeedbackAnalyticsCountTile) zorunlu

Özet satırında sayaç kutusu: dönem içindeki yorum sayısı ve oranı. Dönem içinde hiç yorum yoksa percent değeri null olur. Karşılaştırma dönemine göre değişiklik kasıtlı olarak iletilmez: yorum sayısı trafiğe bağlıdır, bu nedenle artışı kalite hakkında bilgi vermez.

valueintegerzorunlu

Örnek: 96

percentnumber · float

Örnek: 75

negativeobject (FeedbackAnalyticsCountTile) zorunlu

Özet satırında sayaç kutusu: dönem içindeki yorum sayısı ve oranı. Dönem içinde hiç yorum yoksa percent değeri null olur. Karşılaştırma dönemine göre değişiklik kasıtlı olarak iletilmez: yorum sayısı trafiğe bağlıdır, bu nedenle artışı kalite hakkında bilgi vermez.

valueintegerzorunlu

Örnek: 96

percentnumber · float

Örnek: 75

positive_shareobject (FeedbackAnalyticsShareTile) zorunlu

Pay oranı kutucuğu özet satırında. Sayaçlardan farklı olarak, yüzde puan cinsinden karşılaştırma dönemine göre pay değişimini gösteren dynamics alanını içerir; bu değer trafik miktarından bağımsızdır. Eğer karşılaştırılacak veri yoksa (dönem veya karşılaştırma döneminde hiç geri bildirim yoksa), percent ve dynamics alanları null olur.

valueintegerzorunlu

Örnek: 96

percentnumber · float

Örnek: 75

dynamicsnumber · float

Örnek: -0.2

pointsarray of object
datetimestringzorunlu

Saatlik noktanın başlangıcı (UTC)

Örnek: 2026-09-08 10:00:00

positiveintegerzorunlu

Örnek: 3

negativeintegerzorunlu

Örnek: 1