API hujjatlari

To‘liq hujjatlar: api.ilmora.uz

Base URL

Barcha public API endpointlar quyidagi manzilga nisbatan ishlaydi:

text

https://api.ilmora.uz/api/public

Autentifikatsiya

API kalitingizni Bearer token sifatida yuboring. Kalitlar dashboard ichida yaratiladi va odatda sk- bilan boshlanadi. To‘liq kalit faqat bir marta ko‘rsatiladi — xavfsiz joyda saqlang.

Authorization header

Authorization: Bearer sk-your-api-key-here

POST /translate

POST/translate

Matnni bir tildan boshqa tilga tarjima qiladi.

Request body

curl -X POST https://api.ilmora.uz/api/public/translate \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "Hello, world!",
  "from_lang": "en",
  "to_lang": "ru"
}'

// Javob

{ "translation": "Привет, мир!", "chars_used": 13 }

Maydon	Turi	Izoh
text	string	Tarjima qilinadigan matn (maks. 10 000 belgi)
from_lang	string	Manba til kodi (masalan: en, uz, ru)
to_lang	string	Maqsad til kodi

Response 200

json

{
  "translation": "Привет, мир!",
  "from_lang": "en",
  "to_lang": "ru",
  "chars_used": 13
}

POST /detect

POST/detect

Matn tilini aniqlaydi.

json

{ "text": "Salom dunyo" }

Response 200

json

{
  "language": "uz",
  "confidence": 0.98,
  "chars_used": 11
}

GET /balance

GET/balance

Kalit egasining joriy balansini qaytaradi. Kredit yechilmaydi.

json

{ "balance_uzs": 8750.00 }

Xatolik kodlari

Status	Xatolik	Ma’nosi
401	API key required.	No Authorization header.
401	Invalid or inactive API key.	Key not found or revoked.
402	Insufficient balance.	See balance_uzs and required_uzs in response.
422	Validation error.	Request body invalid.
429	Too Many Requests.	Rate limit exceeded.
500	Translation failed.	Upstream service error.

402 uchun body namunasi

json

{
  "error": "Insufficient balance.",
  "balance_uzs": 200.00,
  "required_uzs": 500.00
}

Rate limitlar

Layer 0 — Cloudflare

DDoS & bot mitigation at the edge.

Layer 1 — Nginx (per IP)

500 requests / minute per IP. Returns HTTP 429.

Layer 3 — Laravel (per key)

100 requests / minute per API key. Returns JSON 429.

Narxlar

1 000 belgi uchun 500 so‘m (proportsional)

Birinchi kalit yaratilganda 1 000 so‘m bepul balans
Obuna ham, minimal to‘lov ham yo‘q
Oldindan yechiladi — ortiqcha yechilgan summa avtomatik qaytariladi
GET /balance kredit yechmaydi

Balansni to‘ldirish

Balansni to‘ldirish qo‘lda amalga oshiriladi. Biz bilan bog‘laning — bir necha soat ichida kredit qo‘shib beramiz.

Telefon / WhatsApp

+998 95 049 33 55

@OtabekJurabekov