{
    "api": "Dilde Birlik Çeviri API",
    "versiyon": "1.0",
    "base_url": "https:\/\/dildebirlik.org",
    "endpointler": [
        {
            "yol": "POST \/translate.php",
            "aciklama": "Metin çevirisi yapar",
            "istek": {
                "Content-Type": "application\/json",
                "body": {
                    "metin": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Çevrilecek metin (max 5000 karakter)"
                    },
                    "kaynak": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Kaynak dil kodu: tr, az, uz, kk, tk, ky"
                    },
                    "hedef": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Hedef dil kodu: tr, az, uz, kk, tk, ky"
                    },
                    "mod": {
                        "tip": "string",
                        "zorunlu": false,
                        "aciklama": "\"ceviri\" (varsayılan) veya \"acikla\""
                    }
                }
            },
            "yanit": {
                "ceviri": "Çevrilmiş metin",
                "kaynak_dil": "Kaynak dil adı",
                "hedef_dil": "Hedef dil adı",
                "guven_skoru": "Çeviri güven skoru (40-99)",
                "cache": "Cache'den mi geldi (bool)",
                "karmasik": "Karmaşık metin mi (bool)",
                "model": "İç motor sürüm etiketi",
                "ters_dogrulama": "Ters çeviri benzerlik skoru (null veya 0-100)",
                "baglam_uyarilari": "Çok anlamlı kelime uyarıları (array)",
                "latin_karsilik": "Kiril çevirilerin Latin karşılığı (KK\/KY için)",
                "dilbilimci_gerekli": "Dilbilimci incelemesi gerekiyor mu (bool)"
            },
            "ornek_istek": "{\"metin\":\"merhaba\",\"kaynak\":\"tr\",\"hedef\":\"az\"}",
            "ornek_yanit": "{\"ceviri\":\"salam\",\"guven_skoru\":95,\"cache\":true}"
        },
        {
            "yol": "POST \/feedback.php",
            "aciklama": "Çeviri geri bildirimi gönderir",
            "istek": {
                "Content-Type": "application\/json",
                "body": {
                    "kaynak_metin": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Çevrilen kaynak metin"
                    },
                    "ceviri": {
                        "tip": "string",
                        "zorunlu": false,
                        "aciklama": "Üretilen çeviri"
                    },
                    "kaynak": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Kaynak dil kodu"
                    },
                    "hedef": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Hedef dil kodu"
                    },
                    "oy": {
                        "tip": "int",
                        "zorunlu": true,
                        "aciklama": "1 (beğeni) veya 0 (beğenmeme)"
                    },
                    "not": {
                        "tip": "string",
                        "zorunlu": false,
                        "aciklama": "Kullanıcı notu (max 500)"
                    }
                }
            }
        },
        {
            "yol": "GET \/game.php?action=question",
            "aciklama": "Quiz sorusu döndürür",
            "parametreler": {
                "action": "\"question\", \"all_words\" veya \"stats\"",
                "level": "Zorluk seviyesi: 1 (kolay), 2 (orta), 3 (zor), 0 (hepsi)"
            }
        },
        {
            "yol": "POST \/pdf_islem.php",
            "aciklama": "Belge yükleme ve çeviri talebi",
            "istek": {
                "Content-Type": "multipart\/form-data",
                "body": {
                    "pdf": {
                        "tip": "file",
                        "zorunlu": true,
                        "aciklama": "PDF, DOCX veya TXT dosyası (max 10MB)"
                    },
                    "kaynak": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Kaynak dil kodu"
                    },
                    "hedef": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Hedef dil kodu"
                    },
                    "email": {
                        "tip": "string",
                        "zorunlu": true,
                        "aciklama": "Bildirim email adresi"
                    }
                }
            }
        }
    ],
    "dil_kodlari": {
        "tr": "Türkçe (Latin, 29 harf)",
        "az": "Azerbaycanca (Latin, 32 harf)",
        "uz": "Özbekçe (Latin, 29 harf)",
        "kk": "Kazakça (Kiril, 42 harf)",
        "tk": "Türkmence (Latin, 30 harf)",
        "ky": "Kırgızca (Kiril, 36 harf)"
    },
    "rate_limit": {
        "ucretsiz": "5\/dakika, 100\/saat, 200\/gün",
        "kullanici": "15\/dakika, 300\/saat, 800\/gün"
    },
    "guvenlik": {
        "dosya_tarama": "10 katmanlı güvenlik taraması",
        "metadata_temizleme": "PDF\/DOCX metadata otomatik silinir",
        "rate_limiting": "IP bazlı kademeli rate limiting",
        "hata_loglama": "Tüm hatalar JSON formatında loglanır"
    },
    "lisans": "Seed cache verileri CC-BY 2.0 lisanslıdır (Tatoeba)"
}