Transliteratsiya¶

O'zbek matnini Lotin va Kirill yozuvlari o'rtasida o'zgartiradi. Chet so'zlar, apostroflar va kontekstga bog'liq belgilarni to'g'ri transliteratsiya qilish uchun ekspert darajasidagi lingvistik qoidalar bilan ishlaydi.

Endpoint¶

POST /api/v1/transliterate
Content-Type: application/json

So'rov parametrlari¶

Parametr	Turi	Majburiy	Tavsif
`text`	string	Ha	Transliteratsiya qilinadigan manba matni
`direction`	string	Ha	`latin_to_cyrillic` yoki `cyrillic_to_latin`
`blocking`	boolean	Yo'q	`true` (standart) — natijani kutish; `false` — vazifa ID qaytarish
`webhook_url`	string	Yo'q	Vazifa tugaganda POST qaytaruv URL manzili (`blocking=false` bo'lganda majburiy)

Cheklovlar¶

Cheklov	Qiymat
Sinxron (blocking) chegarasi	600 so'z

Eslatmalar:

600 so'zgacha bo'lgan matnlar sinxron ravishda qayta ishlanadi.
600 so'zdan ortiq matnlar uchun blocking=false va webhook_url talab qilinadi.

Lotin → Kirill¶

So'rov

curl -X POST "https://developer.kotib.ai/api/v1/transliterate" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Salom dunyo! O'\''zbek tili juda chiroyli.",
    "direction": "latin_to_cyrillic",
    "blocking": true
  }'

Javob

{
  "status": "success",
  "text": "Салом дунё! Ўзбек тили жуда чиройли."
}

Ko'proq misollar

Lotin kiritish	Kirill natija
`Ertaga maktabga boramiz`	`Эртага мактабга борамиз`
`San'at va madaniyat`	`Санъат ва маданият`
`Aprel oyida`	`Апрель ойида`
`avtomobillar ko'chada`	`автомобиллар кўчада`
`Google va Apple kompaniyalari`	`Google ва Apple компаниялари`

Kirill → Lotin¶

So'rov

curl -X POST "https://developer.kotib.ai/api/v1/transliterate" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Салом дунё! Ўзбек тили жуда чиройли.",
    "direction": "cyrillic_to_latin",
    "blocking": true
  }'

Javob

{
  "status": "success",
  "text": "Salom dunyo! Oʻzbekiston tili juda chiroyli."
}

Ko'proq misollar

Kirill kiritish	Lotin natija
`Европа мамлакатлари`	`Yevropa mamlakatlari`
`Санъат ва маданият`	`San'at va madaniyat`
`Сентябрь ойи`	`Sentabr oyi`
`ШАРҚ университети`	`SHARQ universiteti`
`Телеграм канали`	`Telegram kanali`

Asinxron foydalanish (blocking = false)¶

600 so'zdan ortiq matnlar uchun webhook URL bilan asinxron rejimdan foydalaning.

curl -X POST "https://developer.kotib.ai/api/v1/transliterate" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "...long text...",
    "direction": "latin_to_cyrillic",
    "blocking": false,
    "webhook_url": "https://your-server.com/webhook"
  }'

Javob

{
  "status": "processing",
  "id": "tr_a1b2c3d4-...",
  "message": "Transliteration scheduled. Poll /get-status or await webhook."
}

Vazifa holatini GET /api/v1/get-status/tr_<task_id> orqali tekshiring yoki webhook qaytaruvini kuting.

Xatolik javoblari¶

Xatolik	Javob
Bo'sh matn	`{"error": "Empty text"}`
Asinxron uchun webhook mavjud emas	`{"error": "Webhook URL is required for non-blocking tasks"}`
Noto'g'ri API kalit	`{"error": "Invalid API key"}`
Balans yetarli emas	`{"error": "Insufficient balance"}`

HTTP holat kodlari¶

Kod	Tavsif
`200`	Muvaffaqiyat — natija darhol qaytarildi
`202`	Qabul qilindi — vazifa navbatga qo'yildi (asinxron rejim)
`400`	Noto'g'ri so'rov — parametrlar xato
`401`	Avtorizatsiyasiz — API kalit noto'g'ri yoki mavjud emas
`402`	To'lov talab qilinadi — balans yetarli emas
`500`	Ichki server xatosi

- ← Oldingi: Narxlar | Bosh sahifaga →