Geliştirici Dokümantasyonu

jekcms API Referansı

jekcms'i uygulamalarınıza entegre edin. İçerik yönetimi, medya yükleme, webhook tetikleyicileri ve istatistik sorgulama için kapsamlı REST API.

REST API v1 API Anahtarı Gerekli JSON

Base URL https://yourdomain.com/api/v1

Kimlik Doğrulama

Tüm API istekleri, her istekle birlikte gönderilmesi gereken bir API anahtarı gerektirir. Anahtarınızı jekcms admin panelinden Ayarlar → API bölümünden 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" {"status":"ok","data":[...],"total":42,"page":1}

Güvenlik notu: API anahtarınızı istemci tarafı koduna (JavaScript, HTML) gömmeyiniz. Sunucu tarafı entegrasyonlar veya n8n gibi otomasyon araçları için 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" | "all" (default: "published") category string — Filter by category slug search string — Full-text search in title and content order string — "desc" | "asc" (default: "desc") order_by string — "date" | "title" | "views" (default: "date")

Yazı Oluşturma — POST /posts

{ "title": "My Post Title", "content": "<p>Full HTML content here</p>", "excerpt": "Short description", "status": "published", // "published" | "draft" "category_id": 3, "featured_image": "images/2026/01/cover.avif", "tags": ["php", "cms", "tutorial"], "seo_title": "My Post Title | jekcms", "seo_description": "SEO meta description (max 160 chars)" }

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 otomatik olarak AVIF ve WebP formatlarına dönüştürür. Orijinal dosya da saklanır. Yanıtta her üç URL döner.

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 image file — JPG / PNG / WebP / AVIF (max 10MB) alt string — Alt text (optional) folder string — Target folder e.g. "2026/05" (optional)

Yanıt Örneği

{ "success": "true", "id": 142, "filename": "photo.avif", "original_name": "photo.jpg", "path": "images/2026/05/photo.avif", "url": "https://yourdomain.com/uploads/images/2026/05/photo.avif", "size": 184320, "mime_type": "image/avif", "is_image": "true" }

Kategoriler

GET /api/v1/categories Tüm kategorileri listele

GET /api/v1/categories/{slug} Kategori detayı

Kategori Listesi Yanıtı

{ "status": "ok", "data": [ { "id": 1, "name": "Technology", "slug": "technology", "description": "Tech news and reviews", "post_count": 47 } ] }

Webhooks

jekcms webhook uçları gelen yöndedir: n8n ya da başka bir sistem bu adreslere POST atarak yazı yayımlar, taslak bırakır, medya yükler veya içerik kuyruğunu yönetir. Kimlik doğrulama API anahtarıyla yapılır; anahtarsız çağrılar için X-Webhook-Signature imzası doğrulanır.

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 gönderim

GET /api/v1/webhook/queue-pending İşlenmeyi bekleyen kuyruk

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", "category": "technology", "image": "https://example.com/cover.jpg" }

Aldığınız Yanıt

{ "success": "true", "post_id": 256, "slug": "my-new-article", "status": "draft", "url": "https://yourdomain.com/my-new-article" }

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 belirir; yayın kararı sizde kalır.

İstatistikler

GET /api/v1/stats Site metrikleri

GET /stats Yanıtı

{ "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: {"status":"error","code":401,"message":"..."}. 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` header'ında gönderin.
403	Erişim reddedildi	API anahtarınızın bu kaynağa erişim izni yok.
404	Kayıt bulunamadı	ID veya slug'ı kontrol edin.
422	Doğrulama hatası	Yanıttaki `errors` dizisini inceleyerek hangi alanların hatalı olduğunu görün.
429	Çok fazla istek	Rate limit aşıldı. `Retry-After` header'a bakın ve bekleme süresi kadar bekleyin.
500	Sunucu hatası	Sunucu tarafında beklenmedik bir hata oluştu. Sorun devam ederse destek ekibiyle iletişime geçin.

429 için yeniden deneme: Eksponansiyel geri çekilme (exponential backoff) kullanın. İlk deneme 1s, ikinci 2s, üçüncü 4s bekleyerek deneyin. n8n'de bu 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 dakikalar içinde entegrasyon 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