JekCMS REST API'sine özel endpointler ekleme — kimlik doğrulama ara katmanından sayfalamaya, filtrelemeye ve webhook tetikleyicilerine.
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. jekcms'in gercek API'si tek bir authenticate() metodunu dogrudan cagirir — cekirdekte ayri bir requireAuth() sarmalayicisi yoktur; X-API-Key header'ini veya Bearer token'i kontrol eden tek bir metottur.
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.
Harici Bildirim Tetikleme
jekcms'in cekirdeginde genel amacli, disa-dogru (outbound) bir webhook tablosu veya gonderim sistemi yoktur — yerleşik webhook destegi n8n'in jekcms'e YAYINLAMASI icindir, jekcms'in keyfi harici sistemleri bilgilendirmesi icin degil. Ozel endpointinizin harici bir servisi bilgilendirmesi gerekiyorsa, bunu kendiniz insa edersiniz: hedef URL'yi ve paylasilan bir sirri kullanim durumunuza uygun bir yerde saklayin, yuku jekcms'in kendi webhook kodunun yaptigi gibi imzalayin ve istegi gonderin.
