Ma’lumotnomalar va fayllar

Avtorizatsiyadan o‘tgan foydalanuvchilar uchun umumiy yordamchi metodlar: ochiluvchi maydonlar uchun ro‘yxatlar, ma’lumotnoma yozuvlarini tez yaratish, rasmlarni yuklash va fayllarni o‘qish.

Metod	Manzil	Vazifasi
GET	/common/public/records/{type}	Ma’lumotnoma yozuvlari ro‘yxati
POST	/common/public/create-record/{type}	Yozuvni tez yaratish
POST	/common/public/upload-image	Rasmlarni yuklash
GET	/common/public/file/content	Fayl mazmunini olish

Ma’lumotnoma yozuvlari ro‘yxati

GET/common/public/records/{type}

Ochiluvchi maydonlar uchun {type} turi bo‘yicha qisqa ro‘yxat (id + value): stock, supplier, cashbox, product, service, bundle, product_unit, product_category_list, region, region_district, company, partner va boshqalar; turlar va filtrlar to‘plami foydalanuvchi turiga bog‘liq. filter[id], filter[value] (qism satr bo‘yicha qidiruv) va show[]=with-deleted/only-deleted qo‘llab-quvvatlanadi. Ruxsat etilmagan tur — 400 Unavailable type.

Sarlavhalar (headers)

Sarlavha	Qiymat	Tavsif
Authorization	Bearer {token}	POST /common/auth/login dan olingan token
Accept	application/json	Javob JSON da
Accept-Language	ru	Xabarlar va nomlar tili: ru, uz, oz

Yo‘l parametrlari

Parametr	Tavsif
type	Turi (metod tavsifiga qarang)

So‘rov parametrlari

Parametr	Tavsif
show[]	Qo‘shimcha hisoblangan ma’lumotlar (metod tavsifiga qarang)

GET /common/public/records/company?show[0]=with-deleted

Javob · 200

Sahifalangan javob: yozuvlar data[] ichida, sahifalash links va meta da.

Javob maydonlari

Maydon	Turi	Tavsif
data	object[]	Ma'lumotlar
data[].id	integer	ID
data[].value	string	Ma'nosi
data[].is_deleted	boolean

{
    "data": [
        {
            "id": 2,
            "value": "Company 1-1",
            "is_deleted": false
        }
    ],
    "links": {
        "first": "https://api.wasyt.uz/common/public/records/company?page=1",
        "last": "https://api.wasyt.uz/common/public/records/company?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/common/public/records/company",
        "per_page": 20,
        "to": 1,
        "total": 1
    }
}

Yozuvni tez yaratish

POST/common/public/create-record/{type}

Kompaniya direktori yoki xodimi uchun ma’lumotnoma yozuvini to‘g‘ridan-to‘g‘ri formadan yaratadi (kiritish bilan yaratish). {type}: product_brand, product_category, product_option, product_specification. Nom noyob bo‘lishi kerak; kategoriyaning satr ko‘rinishidagi name i barcha tillarga nusxalanadi. Yaratilgan yozuvni qaytaradi. Daqiqasiga 3 tadan ko‘p bo‘lmagan so‘rov.

Sarlavhalar (headers)

Sarlavha	Qiymat	Tavsif
Authorization	Bearer {token}	POST /common/auth/login dan olingan token
Accept	application/json	Javob JSON da
Accept-Language	ru	Xabarlar va nomlar tili: ru, uz, oz

Yo‘l parametrlari

Parametr	Tavsif
type	Turi (metod tavsifiga qarang)

So‘rov tanasi

Maydon	Turi	Majburiy	Tavsif
name	string, object	Ha	Nom. product_brand va product_option uchun — satr; product_category uchun — satr yoki tillar bo‘yicha obyekt; product_specification uchun — tillar bo‘yicha obyekt (name.ru, name.uz, name.oz)
specification_id	integer	Yo‘q	Xususiyat ID si; product_option uchun majburiy

JSON

{
    "name": "Инлайн категория"
}

cURL

curl -X POST "https://api.wasyt.uz/common/public/create-record/product_category" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"name":"Инлайн категория"}'

Javob · 200

Javob maydonlari

Maydon	Turi	Tavsif
name	object	Nomlanish
name.ru	string
name.uz	string
name.oz	string
updated_at	string	Yangilangan
created_at	string	Yaratilgan
company_id	integer	Kompaniya
parent_id	integer	Ota-ona
lft	integer
rgt	integer
id	integer	ID
is_deleted	boolean

{
    "name": {
        "ru": "Инлайн категория",
        "uz": "Инлайн категория",
        "oz": "Инлайн категория"
    },
    "updated_at": "2026-09-30 12:50:33",
    "created_at": "2026-09-30 12:50:33",
    "company_id": 1,
    "parent_id": 1,
    "lft": 16,
    "rgt": 17,
    "id": 17,
    "is_deleted": false
}

Rasmlarni yuklash

POST/common/public/upload-image

1 dan 10 tagacha rasmni omborga (MinIO) folder papkasiga (standart — uploads) yuklaydi, 800x600 ko‘rinishidagi size berilsa — o‘lchamini o‘zgartirib. Xuddi shu tartibda to‘liq ochiq URL lar — files ni qaytaradi.

Sarlavhalar (headers)

Sarlavha	Qiymat	Tavsif
Authorization	Bearer {token}	POST /common/auth/login dan olingan token
Accept	application/json	Javob JSON da
Accept-Language	ru	Xabarlar va nomlar tili: ru, uz, oz

So‘rov tanasi

Maydon	Turi	Majburiy	Tavsif
images	array	Ha	Rasmlar. Kamida 1 ta element. Maks. 10 ta element
images[]	file	Yo‘q	Rasmlar. Formatlar: jpg, png. Maks. 2048 KB. Rasm o‘lchamlari: max_width=3840, max_height=2160
folder	string	Yo‘q	Papka. Maks. 50 belgi. Shablon /^[A-Za-z0-9_\-]+$/
size	string	Yo‘q	Oʻlcham. Shablon /^\d{1,5}x\d{1,5}$/

JSON

{
    "folder": "avatars",
    "size": "800x600"
}

cURL

curl -X POST "https://api.wasyt.uz/common/public/upload-image" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"folder":"avatars","size":"800x600"}'

Javob · 200

Javob maydonlari

Maydon	Turi	Tavsif
files	array

{
    "files": [
        "https://api-minio.icangroup.uz/wasyt/images/avatars/2026/09/30/6abcbf5f7c794_e5264d7a-d642-4809-88cc-b80538088cb7.png"
    ]
}

Xato misoli · 422

{
    "message": "Поле Изображения обязательно для заполнения.",
    "errors": {
        "images": [
            "Поле Изображения обязательно для заполнения."
        ]
    }
}

Fayl mazmunini olish

GET/common/public/file/content

Ilovaning ochiq katalogidagi faylni path yo‘li yoki to‘liq URL i bo‘yicha beradi. Yo‘l ochiq katalogdan tashqariga chiqsa, fayl topilmasa yoki 100 MB dan katta bo‘lsa — 400 xatosi.

Sarlavhalar (headers)

Sarlavha	Qiymat	Tavsif
Authorization	Bearer {token}	POST /common/auth/login dan olingan token
Accept	application/json	Javob JSON da
Accept-Language	ru	Xabarlar va nomlar tili: ru, uz, oz

So‘rov parametrlari

Maydon	Turi	Majburiy	Tavsif
path	string	Ha	Ochiq katalog ichidagi fayl yo‘li yoki uning to‘liq URL i (255 belgigacha)

Javob · 200

Javob — fayl yoki matn, JSON emas.