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.

REST API v1 API Anahtarı Gerekli JSON
Base URL 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)

# X-API-Key header GET /api/v1/posts X-API-Key: your_api_key_here # Bearer token (alternative) GET /api/v1/posts Authorization: Bearer your_api_key_here

cURL Örneği

Terminal
$ curl -X GET "https://yourdomain.com/api/v1/posts" \ -H "X-API-Key: your_api_key_here" \ -H "Content-Type: application/json" {"success":true,"data":{"items":[...],"total":42,"pages":3,"current_page":1,"per_page":20}}

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)

GET /api/v1/posts Tüm yazıları listele
GET /api/v1/posts/{id} Tek yazı getir
POST /api/v1/posts Yeni yazı oluştur
PUT /api/v1/posts/{id} Yazıyı güncelle
DELETE /api/v1/posts/{id} Yazıyı sil

Parametreler - GET /posts

# Query parameters page integer - Page number (default: 1) per_page integer - Results per page (default: 20, max: 100) status string - published | draft | scheduled | pending | trash (omit for all) type string - post | page category string - Category slug (also matches direct child categories) tag string - Tag slug author_id integer - Author user id search string - Search in title and content order_by string - id | created_at | updated_at | published_at | title | view_count | status | author_name order_dir string - DESC | ASC (default: created_at DESC) with_relations 1 - Include categories and tags

Yazı Oluşturma - POST /posts

{ "title": "My Post Title", "content": "<p>HTML or Markdown content</p>", "excerpt": "Short description", "status": "draft", // draft (default) | published | scheduled "categories": [3], // category ids "tags": ["php", "cms"], "featured_image": "images/2026/01/cover.avif", "seo": { "meta_title": "My Post Title", "meta_description": "Up to 160 characters" } }

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)

POST /api/v1/media Görsel yükle
GET /api/v1/media Medya kütüphanesi
DELETE /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

# multipart/form-data POST /api/v1/media X-API-Key: your_api_key_here Content-Type: multipart/form-data # Form fields file file - jpg, jpeg, png, gif, webp, avif, pdf, doc, docx, xls, xlsx, zip, txt (max 50MB) alt string - Alt text (optional) title string - Library title (optional) # Or a JSON body instead of a file: {"url": "https://...", "alt": "..."} (max 25MB)

Yanıt Örneği

{ "success": true, "data": { "success": true, "id": 142, "filename": "photo-8f3a12c4.avif", "original_name": "photo.jpg", "path": "images/2026/05/photo-8f3a12c4.avif", "url": "https://yourdomain.com/uploads/images/2026/05/photo-8f3a12c4.avif", "size": 184320, "mime_type": "image/avif", "is_image": true, "formats": { avif, webp }, "thumbnails": { thumbnail, medium, large, ... } } }

Kategoriler

GET /api/v1/categories Tüm kategorileri listele
GET /api/v1/categories/{id} Kategori detayı

Kategori Listesi Yanıtı

{ "success": true, "data": [ { "id": 1, "name": "Technology", "slug": "technology", "description": "Tech news and reviews", "parent_id": null, "post_count": 47 } ] }

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).

POST /api/v1/webhook/publish Yazıyı doğrudan yayımla
POST /api/v1/webhook/draft Taslak olarak bırak (önerilen)
POST /api/v1/webhook/schedule İleri tarihe zamanla
POST /api/v1/webhook/media URL'den görsel yükle
POST /api/v1/webhook/bulk-publish Toplu yayın
POST /api/v1/webhook/queue-pending Zamanı gelen planlı görevleri al
POST /api/v1/webhook/test Bağlantı testi

Gönderdiğiniz İstek

# POST /api/v1/webhook/draft { "title": "My New Article", "content": "<p>Article body as HTML</p>", "excerpt": "One-sentence summary", "categories": ["Technology"], // names or ids; unknown names are created "tags": ["cms"] }

Aldığınız Yanıt

{ "success": true, "data": { "success": true, "id": 256, "status": "draft" } }

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

# POST - sizin URL'inize / to your URL # X-Jek-Event: post_published # X-Jek-Signature: sha256=<HMAC-SHA256(body, secret)> { "event": "post_published", "site": "https://yourdomain.com", "timestamp": "2026-08-28T12:00:00+00:00", "data": { "id": 256, "title": "My New Article", "slug": "my-new-article", "status": "published", "url": "https://yourdomain.com/my-new-article" } }

İ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

GET /api/v1/stats Site metrikleri

GET /stats Yanıtı

{ "success": true, "data": { "posts": { "published": 318, "draft": 24, "scheduled": 6 }, "comments": { "total": 1204, "pending": 12, "approved": 1192 }, "media": { "total_files": 512, "images": 498, "total_size_formatted": "284.6 MB" }, "categories": 8, "tags": 46, "users": 3 } }

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

Yeniliklerden ilk sen haberdar ol

Yeni özellikler, sürüm notları ve CMS rehberleri. Ayda birkaç e-posta gönderiyoruz.