Glossa Developer

Public API Dokümantasyonu

Glossa Public API'si aracılığıyla kelime kütüphanelerine, gramer konularına, forum tartışmalarına, blog yazılarına ve çeviri servisimize erişebilirsiniz.

Standard Responses Bearer Token Auth v1 Release

Geliştirici Kimlik Doğrulaması

API endpoint'leri hem Glossa web uygulaması (çerez tabanlı oturum) hem de üçüncü parti entegrasyonlar için güvenli hale getirilmiştir. Üçüncü parti bir istemciden gelen isteklerin HTTP başlığında geçerli bir Bearer token içermesi gerekir.

Authorization Header Kullanımı

Authorization: Bearer <YOUR_API_TOKEN>

* API token'ınızı profil sayfanızdaki "Eklenti / API Ayarları" sekmesinden üretebilirsiniz. Resmi mobil uygulamalarımız ve tarayıcı eklentimiz bu kimlik doğrulamayı otomatik olarak yönetir.

Arama ve Kelime Endpoint'leri

GET /api/v1/search

Hızlı otomatik tamamlama araması. Terimler veya tanımlar içinde eşleşmeleri puanlayarak döndürür.

Query Parametreleri:
  • q (Zorunlu): Aranacak kelime veya kelime parçası (min 2 karakter).
  • limit (Opsiyonel): Dönecek sonuç limiti (Varsayılan 20, max 30).
  • target (Opsiyonel): Tanım dili filtresi (Örn: TR, varsayılan TR).

Örnek istek kopyalandı!

GET /api/v1/words

Kelime kütüphanesini detaylı olarak listeleme, dil ve profesyonel alan (domain) filtresi uygulama endpoint'i.

Query Parametreleri:
  • q (Opsiyonel): Kelime metni veya tanım içinde arama filtresi.
  • lang (Opsiyonel): Kelimenin kaynak dili (Örn: DE, EN).
  • targetLang (Opsiyonel): Tanım dili (Örn: TR).
  • domain (Opsiyonel): Profesyonel alan kategorisi filtresi (Örn: LEGAL, MEDICAL, TECHNICAL).
  • page (Opsiyonel): Sayfa numarası (Varsayılan 1).
  • limit (Opsiyonel): Sayfa başına sonuç (Varsayılan 20, max 50).

Örnek istek kopyalandı!

GET /api/v1/word/:id

Tek bir kelimenin tüm detaylarını, tanımlarını, örnek cümlelerini ve bileşik ifadelerini getirir.

Örnek istek kopyalandı!

Çeviri Endpoint'i

GET /api/v1/translate

Lokal veritabanı, DeepL ve OpenRouter AI tabanlı entegre çeviri servisidir.

Query Parametreleri:
  • text (Zorunlu): Çevrilecek metin (max 2000 karakter).
  • target (Zorunlu): Hedef dil kodu (Örn: TR, DE).
  • source (Opsiyonel): Kaynak dil kodu. Belirtilmezse otomatik tespit edilmeye çalışılır.
  • context (Opsiyonel): Çeviri kalitesini artıracak ek metin/bağlam bilgisi.

Örnek istek kopyalandı!

Blog Endpoint'leri

GET /api/v1/blog

Yayınlanmış tüm blog yazılarını sayfalanmış olarak listeler.

Query Parametreleri:
  • page: Sayfa numarası (Varsayılan 1).
  • limit: Sonuç limiti (Varsayılan 10, max 50).

Örnek istek kopyalandı!

GET /api/v1/blog/:slug

Slug değeri belirtilen bir blog yazısının detaylı HTML/Markdown içeriğini ve yazar verisini döndürür.

Örnek istek kopyalandı!

Dil Bilgisi (Gramer) Endpoint'leri

GET /api/v1/grammar

Yayınlanmış dil bilgisi (gramer) kılavuzlarını listeler.

Query Parametreleri:
  • lang: Dil filtresi (Örn: DE).
  • level: Seviye filtresi (Örn: A1, B2).
  • category: Gramer kategorisi (Örn: Verben, Syntax).
  • page: Sayfa numarası.
  • limit: Sonuç limiti.

Örnek istek kopyalandı!

GET /api/v1/grammar/:slug

Belirli bir dil bilgisi konusunun tüm içeriğini ve detaylı açıklamalarını döndürür.

Örnek istek kopyalandı!

Forum ve Tartışma Endpoint'leri

GET /api/v1/forum

Aktif forum başlıklarını sayfalanmış olarak listeler.

Query Parametreleri:
  • tag: Belirli etiketlere sahip konuları filtreler.
  • page: Sayfa numarası.
  • limit: Sayfa limitleri (max 50).

Örnek istek kopyalandı!

GET /api/v1/forum/:slug

Seçilen forum konusunu, yazarını ve konuya verilmiş olan tüm cevapları (replies) detaylı olarak döndürür.

Örnek istek kopyalandı!

Standart Cevap Sözleşmesi

Tüm Glossa API v1 servisleri tek biçimli bir JSON çıktısı ile cevap verir. Her yanıt, takip edilebilirliği sağlayan benzersiz bir traceId içerir.

Başarılı Yanıt (Success 200/201) 

{
  "success": true,
  "traceId": "9f8a3c2d...",
  "data": {
    "result": "..."
  }
}

Hatalı Yanıt (Error 4xx/5xx) 

{
  "success": false,
  "code": "VALIDATION_ERROR",
  "message": "Aranacak kelime filtresi zorunludur.",
  "traceId": "3b2e5d1f...",
  "details": []
}