Geliştirici Dokümantasyonu
jekcms API Referansı
jekcms'i kendi uygulamalarınıza bağlayın. REST API ile içerik yönetebilir, medya yükleyebilir, webhook tetikleyebilir ve istatistik sorgulayabilirsiniz.
https://yourdomain.com/api/v1
Kimlik Doğrulama
Her API isteğiyle birlikte bir API anahtarı gönderilmelidir. Anahtarınızı jekcms yönetim panelinde Yönetim → API Anahtarları ekranından oluşturabilirsiniz.
Header ile Kimlik Doğrulama (Önerilen)
cURL Örneği
Güvenlik notu: API anahtarınızı istemci tarafı koduna (JavaScript, HTML) koymayın. Anahtarı yalnızca sunucu tarafı entegrasyonlarda veya n8n gibi otomasyon araçlarında kullanın.
Yazılar (Posts)
/api/v1/posts
Tüm yazıları listele
/api/v1/posts/{id}
Tek yazı getir
/api/v1/posts
Yeni yazı oluştur
/api/v1/posts/{id}
Yazıyı güncelle
/api/v1/posts/{id}
Yazıyı sil
Parametreler - GET /posts
Yazı Oluşturma - POST /posts
n8n entegrasyonu: n8n'de jekcms'e yazı göndermek için HTTP Request node'unu kullanın. Method: POST, URL: /api/v1/posts, Headers: X-API-Key. JSON body'yi Set node ile hazırlayın.
Medya (Media)
/api/v1/media
Görsel yükle
/api/v1/media
Medya kütüphanesi
/api/v1/media/{id}
Medyayı sil
jekcms yüklenen görselleri yükleme sırasında AVIF (birincil) ve WebP (yedek) biçimlerine dönüştürür ve küçük boyutlarını üretir. İki biçim de oluştuktan sonra orijinal JPEG, PNG ya da GIF silinir; yanıttaki path ve url AVIF dosyasını gösterir. Sunucuda GD yoksa dosya orijinal biçiminde saklanır.
Görsel Yükleme - POST /media
Yanıt Örneği
Kategoriler
/api/v1/categories
Tüm kategorileri listele
/api/v1/categories/{id}
Kategori detayı
Kategori Listesi Yanıtı
Webhooks
Webhook'lar iki yönde çalışır. Gelen uçlar: n8n ya da başka bir sistem aşağıdaki adreslere POST atarak yazı yayımlar, taslak bırakır, medya yükler veya toplu planlanan görevleri işler. Kimlik doğrulama API anahtarıyla yapılır; anahtarsız çağrılar 401 alır. Giden webhook'lar: jekcms, içerik olaylarında sizin belirlediğiniz URL'e imzalı JSON bildirimi gönderir (aşağıda).
/api/v1/webhook/publish
Yazıyı doğrudan yayımla
/api/v1/webhook/draft
Taslak olarak bırak (önerilen)
/api/v1/webhook/schedule
İleri tarihe zamanla
/api/v1/webhook/media
URL'den görsel yükle
/api/v1/webhook/bulk-publish
Toplu yayın
/api/v1/webhook/queue-pending
Zamanı gelen planlı görevleri al
/api/v1/webhook/test
Bağlantı testi
Gönderdiğiniz İstek
Aldığınız Yanıt
n8n ile kullanım: n8n akışınızın sonuna bir HTTP Request node ekleyin, adres olarak /api/v1/webhook/draft yazın ve API anahtarınızı X-API-Key başlığında gönderin. Üretilen içerik panelinizde taslak olarak görünür ve ne zaman yayınlanacağına siz karar verirsiniz.
Giden Webhook'lar
Yönetim → API Anahtarları ekranının Giden Webhook'lar bölümünde bir kayıt oluşturun: bir ad ve https:// ile başlayan hedef adresinizi girin, isterseniz kaydı belirli olaylarla sınırlayın. İmza anahtarını jekcms üretir ve yalnızca bir kez gösterir. Beş olay vardır: post_published, post_updated, post_deleted, comment_created (yeni yorum: id, post_id, author_name, status) ve member_registered (e-postasını doğrulayan yeni üye: id, name, email). Her teslimat aynı ekranda günlüklenir; başarısız teslimatı tek tıkla yeniden gönderebilirsiniz.
Aldığınız İstek
İmza doğrulama: gövdenin HMAC-SHA256 özetini kendi anahtarınızla hesaplayıp X-Jek-Signature başlığındaki sha256=… değeriyle karşılaştırın. Eşleşmeyen isteği işlemeyin.
İstatistikler
/api/v1/stats
Site metrikleri
GET /stats Yanıtı
Hata Kodları
Tüm hata yanıtları aynı yapıyı kullanır: {"success":false,"error":{"code":401,"message":"..."}}. Tek istisna yayın kalite kapısının 422 yanıtıdır; bu yanıt bir blocks dizisi döndürür. Aşağıdaki tabloda olası hata kodları ve önerilen çözümler listelenmiştir.
| Kod | Anlamı | Çözüm |
|---|---|---|
| 400 | Geçersiz istek | JSON formatını ve zorunlu alanları kontrol edin. |
| 401 | Kimlik doğrulanamadı | API anahtarınızı X-API-Key ya da Authorization: Bearer başlığında gönderin; anahtarın etkin olduğunu ve süresinin dolmadığını kontrol edin. |
| 403 | Erişim reddedildi | Anahtarın rolü bu işlem için yetkili değil (örneğin yazar anahtarı başka bir kullanıcının yazısını değiştiremez). |
| 404 | Kayıt bulunamadı | Kimliği kontrol edin; yazı ve medya uçları sayısal kimlik ister. |
| 422 | Kalite kapısı | Yayın kalite kapısı isteği reddetti. Yanıttaki blocks dizisi gerekçeleri listeler (örneğin short_content, duplicate_title). |
| 429 | Çok fazla istek | Hız sınırı aşıldı (istemci IP'si başına saatte 100 istek). Yanıt başlık taşımaz; isteklerinizi seyreltip yeniden deneyin. |
| 500 | Sunucu hatası | Sunucu tarafında beklenmedik bir hata oluştu. Mesajdaki referans kimliği sunucu günlüğündeki satırla eşleşir; sorun devam ederse bu kimlikle destek ekibine yazın. |
429 için yeniden deneme: Bekleme süresini her denemede artırın (exponential backoff): önce 1 saniye, sonra 2, sonra 4 saniye bekleyin. n8n'de bunun için Wait node'unu kullanabilirsiniz.
API'yi Kullanmaya Başlayın
jekcms'i satın alın, API anahtarınızı oluşturun ve entegrasyonunuzu geliştirmeye başlayın.
Fiyatlara Göz At- Tam REST API erişimi
- n8n entegrasyonu (taslak → editör onayı)
- AVIF/WebP otomatik dönüşüm
- Webhook desteği
- API anahtarı yönetimi