Ro‘yxatlar: filtr, saralash, sahifalash

Ro‘yxat endpointlari (GET /company/trade/sale kabi) bir xil parametrlarni qabul qiladi. Har bir ro‘yxatda qaysi filtr va bog‘lanishlar mavjudligi uning sahifasidagi «So‘rov parametrlari» jadvalida keltirilgan.

Parametr	Misol	Vazifasi
filter[<maydon>]	filter[status]=completed	Maydon bo‘yicha filtr
filter[<maydon>][]	filter[status][]=completed&filter[status][]=canceled	Bir nechta qiymat (IN)
filter[<sana>][0], [1]	filter[created_at][0]=2026-09-01&filter[created_at][1]=2026-09-30	Davr: dan / gacha
sort[]	sort[]=-id	Saralash; - — kamayish bo‘yicha
with[]	with[]=client&with[]=transactions	Bog‘liq ma’lumotlarni qo‘shish
page	page=2	Sahifa raqami, 1 dan
page-size	page-size=50	Sahifadagi yozuvlar soni

page-size faqat kichraytiradi

Har bir ro‘yxatning o‘z yuqori chegarasi bor (odatda 20). Undan katta page-size e’tiborsiz qoldiriladi va chegara qo‘llanadi.

Ro‘yxatda yo‘q filtr yoki saralash maydoni xato bermaydi — u shunchaki qo‘llanmaydi. Natija kutilganidek filtrlanmagan bo‘lsa, maydon nomini sahifadagi jadval bilan solishtiring.

Javob

{
  "data": [ … ],
  "links": { "first": "…?page=1", "last": "…?page=3", "prev": null, "next": "…?page=2" },
  "meta": { "current_page": 1, "from": 1, "last_page": 3, "per_page": 20, "to": 20, "total": 57 }
}