REST API v1

API Dokümantasyonu

Contentox API ile kendi uygulamalarınızdan içerik üretin, yönetin ve otomatikleştirin.

Base URL: https://api.contentox.net/v1

Kimlik Doğrulama

Tüm API istekleri Bearer token ile kimlik doğrulaması gerektirir. API anahtarınızı Dashboard > Ayarlar > API bölümünden alabilirsiniz.

Header
Authorization: Bearer YOUR_API_KEY

Güvenlik Uyarısı

API anahtarınızı asla client-side kodda veya public repolarda paylaşmayın. Sunucu tarafında saklayın.

Rate Limits

API istekleri plan tipine göre sınırlıdır. Limit aşıldığında 429 hatası döner.

Plan İstek / Dakika İstek / Gün
Starter 60 1,000
Pro 300 10,000
Enterprise 1,000 Sınırsız

İçerik Oluştur

POST /contents

Belirtilen anahtar kelime ve parametrelere göre yeni bir içerik üretir.

Parametreler

Parametre Tip Açıklama
keyword* string İçeriğin odaklanacağı anahtar kelime
site_id* integer İçeriğin yayınlanacağı site ID'si
language string İçerik dili (tr, en, de). Varsayılan: tr
word_count integer Hedef kelime sayısı. Varsayılan: 1500
tone string Yazım tonu (professional, casual, friendly)
auto_publish boolean Otomatik yayınlama. Varsayılan: false

Örnek İstek

cURL 
curl -X POST https://api.contentox.net/v1/contents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "AI içerik üretimi",
    "site_id": 1,
    "language": "tr",
    "word_count": 2000,
    "tone": "professional",
    "auto_publish": false
  }'

Başarılı Yanıt

200 OK 
{
  "success": true,
  "data": {
    "id": 123,
    "title": "AI İçerik Üretimi: Kapsamlı Rehber",
    "content": "<p>İçerik metni...</p>",
    "keyword": "AI içerik üretimi",
    "status": "draft",
    "word_count": 2047,
    "created_at": "2025-01-05T12:00:00Z"
  }
}

İçerikleri Listele

GET /contents

Tüm içerikleri sayfalanmış olarak listeler.

Query Parametreleri

Parametre Tip Açıklama
site_id integer Belirli bir siteye ait içerikler
status string Durum filtresi (draft, published, pending)
page integer Sayfa numarası. Varsayılan: 1
per_page integer Sayfa başına içerik. Varsayılan: 20

Örnek İstek

cURL 
curl https://api.contentox.net/v1/contents?status=published&page=1 \
  -H "Authorization: Bearer YOUR_API_KEY"

Hata Kodları

API standart HTTP durum kodları kullanır. Hata durumunda detaylı mesaj döner.

Kod Açıklama
200 Başarılı
201 Kaynak oluşturuldu
400 Geçersiz istek
401 Kimlik doğrulama hatası
403 Yetkisiz erişim
404 Kaynak bulunamadı
429 Rate limit aşıldı
500 Sunucu hatası
Hata Yanıtı Örneği 
{
  "success": false,
  "error": {
    "code": "INVALID_KEYWORD",
    "message": "Anahtar kelime en az 3 karakter olmalıdır."
  }
}

Webhooks

Webhook'lar ile içerik üretildiğinde, yayınlandığında veya güncellendiğinde otomatik bildirim alabilirsiniz.

Mevcut Eventler

Event Açıklama
content.created Yeni içerik oluşturulduğunda
content.published İçerik yayınlandığında
content.updated İçerik güncellendiğinde
content.deleted İçerik silindiğinde
site.connected Yeni site bağlandığında

Webhook Payload Örneği

POST (your-webhook-url) 
{
  "event": "content.created",
  "timestamp": "2025-01-05T12:00:00Z",
  "data": {
    "id": 123,
    "title": "AI İçerik Üretimi",
    "site_id": 1,
    "status": "draft"
  }
}

API Kullanmaya Başlayın

Pro ve Enterprise planlarında API erişimi dahildir.

Hemen Başla