📘 Turkcha API (Read-only)

🌐 Bazaviy URL

https://turkcha.ru/api/

⚙️ Asosiy endpointlar

GET /api/

API ishlayotganini tekshirish uchun.

{
  "message": "Turkcha API (read-only) ishlayapti ✅",
  "endpoints": {
    "GET /sozlar": "Barcha so‘zlarni olish",
    "GET /sozlar/{id}": "Bitta so‘zni olish"
  }
}

GET /api/sozlar

Barcha so‘zlarni olish.

[
  {
    "id": 10,
    "uzbek": "kitob",
    "turk": "kitap",
    "created_at": "2025-10-20 09:00:00"
  },
  {
    "id": 9,
    "uzbek": "uy",
    "turk": "ev",
    "created_at": "2025-10-19 14:00:00"
  }
]

GET /api/sozlar/{id}

ID orqali bitta so‘zni olish.

{
  "id": 5,
  "uzbek": "suv",
  "turk": "su",
  "created_at": "2025-10-17 08:00:00"
}

⚠️ Xatolik holatlari

Kod	Xabar	Tavsif
403	Faqat GET so‘rovlarga ruxsat berilgan	POST/PUT/DELETE metodlariga murojaat qilinganda
404	Resurs topilmadi	URL noto‘g‘ri bo‘lsa
500	Server xatosi	Baza yoki PHP xatosi yuz berganda

🔒 Xavfsizlik choralari

• SQL Injection: PDO va prepared statements ishlatilgan ✅
• POST/PUT/DELETE: to‘liq taqiqlangan ✅
• Xatolikni yashirish: foydalanuvchiga texnik tafsilotlar ko‘rsatilmaydi ✅
• HTTPS majburiy: .htaccess orqali yo‘naltirish tavsiya ✅
• CORS boshqaruvi: faqat kerakli domenlarga ruxsat berish mumkin ✅
• Rate limit: IP asosida sekundiga 10 ta so‘rovdan ortig‘ini bloklash tavsiya ✅

🧩 Integratsiya misollari

PHP

$data = file_get_contents("https://turkcha.ru/api/sozlar");
$sozlar = json_decode($data, true);
foreach ($sozlar as $s) {
    echo $s['uzbek'] . " → " . $s['turk'] . "<br>";
}

JavaScript (Fetch)

fetch("https://turkcha.ru/api/sozlar")
  .then(res => res.json())
  .then(data => console.log(data));

📄 Litsenziya va foydalanish

API ochiq holda taqdim etiladi. Foydalanuvchilar ma’lumotlarni o‘qish huquqiga ega, lekin o‘zgartirish yoki o‘chirish huquqiga ega emaslar.
Manba ko‘rsatilishi tavsiya etiladi:

https://turkcha.ru/api