API

Yangiliklarni olish

GET/api/crm/v2/newsv2
operationId: news.default

Foydalanuvchi tiliga tarjima qilingan yangiliklarni qaytaradi. URL'dagi raqamli segment ushbu id ga ega bitta yozuvni qaytaradi.

Avtorizatsiya

api-token + language + role

Javoblar

OK

object
statusstringmajburiy

Qiymatlar:successerror

Misol: success

dataobject
filtersobject
date_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_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

date_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

listarray of object
idintegermajburiy

Misol: 1

date_publicationstring (DataTimeFormatSQL) majburiy

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

titlestringmajburiy

Misol: News item

imagestring

Misol: https://cdn.foodsoul.test/news/39.jpg?v1724923848

contentstringmajburiy

Misol: Best regards, the FoodSoul team

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

Topilmadi