API

Mijozlarning bonus operatsiyalari ro‘yxatini olish

GET/api/crm/v2/clients_bonusesv2
operationId: clientsBonuses.default

Avtorizatsiya

api-token + language + role

So‘rov parametrlari

page_numberinteger

Misol: 1

date_creation_fromstring

Misol: 25/04/2024

date_creation_tostring

Misol: 26/04/2024

chain_idinteger

Misol: 1

branch_idinteger
phone_format_idinteger

Misol: 1

phone_numberstring

Misol: 9999999999

genderstring

Qiymatlar:womanman

downloadstring

Qiymatlar:yes

Misol: yes

Javoblar

OK

object
statusstringmajburiy

Qiymatlar:successerror

Misol: success

dataobject
filtersobject
date_creation_fromobject (FilterDateFrom)
valuestringnull bo‘lishi mumkin

Misol: 2026-08-01 00:00:00

typestringmajburiy

Misol: date

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

date_creation_toobject (FilterDateTo)
valuestringnull bo‘lishi mumkin

Misol: 2026-08-31 23:59:59

typestringmajburiy

Misol: date

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

date_creation_rangeobject (FilterDateRange)

Tayyor sana filtrlash davrlari; pastki chegara foydalanuvchi vaqt mintaqasida hisoblanadi. value — joriy *_from va *_to ga mos keladigan davr; null — ixtiyoriy davr. default — server sanalarsiz so‘rovda avtomatik qo‘llaydigan davr: shu davr bo‘lim birinchi yuklanganda va filtrlash tiklanganda ishlatiladi. Davrning yuqori chegarasi har doim foydalanuvchining joriy kuniga teng, shuning uchun option uni o‘z ichiga olmaydi: tayyor davr uchun *_to uzatish shart emas, server uni o‘zi belgilaydi. Davr bir yildan uzun bo‘lsa, yangi chegara tomonidan qisqartiriladi.

valuestring (DateRange) null bo‘lishi mumkin

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

defaultstring (DateRange) majburiy

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

typestringmajburiy

Misol: select

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

optionarray of objectmajburiy
valuestring (DateRange) majburiy

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

date_fromstringmajburiy

Misol: 25/08/2026

branch_idobject (FilterSelectInteger)
valueinteger

Misol: 8920

typestringmajburiy

Misol: select

optionarray of object
valueintegermajburiy

Misol: 8920

namestringmajburiy

Misol: Green Basket | Kaliningrad

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

phone_format_idobject (FilterSelectInteger)
valueinteger

Misol: 8920

typestringmajburiy

Misol: select

optionarray of object
valueintegermajburiy

Misol: 8920

namestringmajburiy

Misol: Green Basket | Kaliningrad

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

phone_numberobject (FilterInput)
valuestring

Misol: example

typestringmajburiy

Misol: integer or string

placeholderstring

Misol: string

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

genderobject (FilterEnum)

Filter-enum — enum qiymatlarining tekis ro‘yxati

valuestring

Misol: example

typestringmajburiy

Misol: select

optionarray of string
modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

downloadobject (FilterButtonDownloadCsv)

Tanlab olingan ma'lumotlarni yuklab olish tugmasi: bosilganda download=yes ni yuboring

valuestring

Misol: Download

typestringmajburiy

Misol: button_download_csv

system_automationboolean

Misol: true

listarray of object
idintegermajburiy

Misol: 1

date_creationstring (DataTimeFormatSQL) majburiy

Misol: 2024-05-02 08:31:16

date_availablestring (DataTimeFormatSQL)

Misol: 2024-05-02 08:31:16

date_expirationstring (DataTimeFormatSQL)

Misol: 2024-05-02 08:31:16

date_changestring (DataTimeFormatSQL)

Misol: 2024-05-02 08:31:16

typestringmajburiy

Qiymatlar:birthdayfeedbackpromo_coderegistrationinvitationreferral_codereferralordergift

Misol: gift

descriptionstring

Misol: bonuses for the registration

sumnumbermajburiy

Misol: 135

order_idinteger

Misol: 0

feedback_idinteger

Misol: 0

statusstringmajburiy

Qiymatlar:availablenot_available

Misol: available

branch_idinteger

Misol: 1

order_numberinteger

Misol: 1

feedback_datestring (DataTimeFormatSQL)

Misol: 2024-05-02 08:31:16

client_namestring

Misol: client name

client_phone_format_idinteger

Misol: 1

client_phone_numberstring

Misol: 9638887321

chain_namestring

Misol: Green Basket

spent_sumnumbermajburiy

Misol: 135

paginationobject (Pagination)
max_countintegermajburiy

Sahifadagi elementlar soni

Misol: 30

page_numberintegermajburiy

Joriy sahifa raqami; siljish 1000 dan oshmasligi uchun cheklangan

Misol: 1

has_nextbooleanmajburiy

Keyingi sahifa mavjudmi

Misol: true

has_previousbooleanmajburiy

Oldingi sahifa mavjudmi

Misol: false