A
Aivoc
Kirish Ro'yxatdan o'tish

API Hujjatlari

Aivoc tizimi bilan integratsiya qilish uchun qo'llanma.

GET

/api/themes

Mavzular ro'yxatini olish

Barcha mavzular va ularga tegishli so'zlar ro'yxatini qaytaradi.

{
    "success": true,
    "data": [
        {
            "id": 1,
            "name": "Oilaviy so'zlar",
            "slug": "oilaviy-sozlar-...",
            "image": "themes/example.jpg",
            "words": [
                {
                    "id": 10,
                    "word_en": "Father",
                    "translation": "Ota",
                    "image": "words/father.jpg"
                }
            ]
        }
    ]
}
POST

/api/themes

Yangi mavzu va so'zlar qo'shish

Yangi mavzu yaratish va unga bir vaqtning o'zida so'zlarni biriktirish. multipart/form-data formatida yuborilishi kerak.

Parametrlar:

  • name (required): Mavzu nomi
  • image (optional): Mavzu rasmi (file)
  • words[0][word_en]: 1-so'z inglizchasi
  • words[0][translation]: 1-so'z tarjimasi
  • words[0][image]: 1-so'z rasmi (file)
  • words[0][example_sentence]: 1-so'z uchun namuna (optional)
// Muvaffaqiyatli javob (201 Created)
{
    "success": true,
    "message": "Mavzu va so'zlar muvaffaqiyatli saqlandi",
    "data": { ... }
}
POST (PUT)

/api/themes/{id}

Mavzuni yangilash
Eslatma: HTML formalar orqali fayl yuborishda PUT metodi ishlamaydi. Shuning uchun POST metodi bilan _method=PUT parametri qo'shib yuborilishi kerak.

Mavzu ma'lumotlarini o'zgartirish. Agar so'zlar massivi yuborilsa, mavzudagi so'zlar to'liq yangilanadi (sinxronizatsiya qilinadi).

So'zni yangilash yoki qo'shish:

Agar so'z obyektida id ko'rsatilsa, o'sha so'z yangilanadi. Agar id bo'lmasa, yangi so'z yaratiladi.

DELETE

/api/themes/{id}

Mavzuni o'chirish

Mavzuni o'chiradi. Unga bog'langan so'zlar bazada qoladi, lekin mavzudan uziladi.