API Mimari Genel Bakis

JekCMS REST API, sinif tabanli bir yönlendiriciye sahip tek bir PHP dosyasidir (api/v1/index.php). Tum istekler .htaccess yeniden yazma kurallari araciligiyla bu giriş noktasina gider, URL'yi ayristirir, istegi doğrular ve uygun işleyici yonteme yönlendirir.

Ozel Endpoint Oluşturma

Yeni bir endpoint eklemek için bir işleyici yontemi ve bir rota durumu eklersiniz. Ornegin site istatistiklerini donduren bir /api/v1/stats endpointi eklemek.

Kimlik Dogrulama

Tum özel endpointler API anahtari kimlik doğrulamasini kullanmalidir. requireAuth() yontemi X-API-Key header'ini veya Bearer token'i kontrol eder.

Sayfalama

Sayfalama fonksiyonu sorguyu, parametreleri, sayfa ve sayfa başına oge sayisini alir. Toplam sayiyi hesaplar, LIMIT/OFFSET ekler ve sayfalama meta verileriyle birlikte ogeleri dondurur.

Filtreleme

Sorgu parametreleri parametreli sorgularla WHERE tumulcelerine eslenir (asla string birlestirme degil). Kategori, durum ve diger alanlar sorgu dizesinden güvenli bir sekilde alinir.

Webhook Tetikleyiciler

Ozel endpointler işlemlerden sonra webhooklar tetikleyebilir. Async yaklasim webhook teslimatinin API yanitini yavaslatmamasini sağlar. Harici sistem cokmusse webhook sessizce basarisiz olur — hatalar hata ayiklama için loglanir ancak yeniden denenmez.