Makale İşlemleri

SeoAuthor API'nin en güçlü özelliklerinden biri, yüksek kaliteli makaleler üretebilme yeteneğidir. Bu bölümde, makale oluşturma, yönetme ve yapılandırma işlemlerini öğreneceksiniz.

🎯 Makale İşlemleri Genel Bakış

API aracılığıyla şu makale işlemlerini gerçekleştirebilirsiniz:

• Makale Oluşturma: Tek başlık ile makale üretimi
• Toplu Makale Oluşturma: Birden fazla makaleyi aynı anda üretme
• Makalelerim: Oluşturulan makaleleri listeleme ve filtreleme
• Yazım Tonları: Mevcut yazım tonu seçeneklerini görüntüleme
• Makale Boyutları: Desteklenen makale boyutlarını öğrenme

📋 Makale Endpoints

Endpoint	Method	Açıklama
/api/v1/makaleler/makale-olustur	POST	Tek makale oluştur
/api/v1/makaleler/toplu-makale-olustur	POST	Toplu makale oluştur
/api/v1/makaleler/makalelerim	GET	Makalelerinizi listele
/api/v1/makaleler/yazim-tonlari	GET	Yazım tonlarını getir
/api/v1/makaleler/makale-boyutları	GET	Makale boyutlarını getir

🎨 Yazım Tonları

Makalelerinizi farklı yazım tonlarında oluşturabilirsiniz:

ID	Ton	Açıklama
1	Profesyonel	Formal ve teknik dil
2	Samimi	Dostane ve yakın dil
3	Eğitici	Öğretici ve açıklayıcı
4	Ikna Edici	Satış odaklı ve motive edici
5	Yaratıcı	Artistik ve özgün

📏 Makale Boyutları

Farklı boyutlarda makaleler oluşturabilirsiniz:

ID	Boyut	Kelime Sayısı	Kullanım Alanı
1	Kısa	300-500	Blog postları, sosyal medya
2	Orta	800-1200	Standart makaleler
3	Uzun	1500-2000	Detaylı rehberler
4	Çok Uzun	2500+	Kapsamlı raporlar

🚀 Hızlı Başlangıç

1. Basit Makale Oluşturma

const response = await fetch(
  "https://integration.seoauthor.ai/api/v1/makaleler/makale-olustur",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      baslik: "JavaScript ile Modern Web Geliştirme",
      yazimTonu: 1, // Profesyonel
      makaleBoyutu: 2, // Orta
    }),
  }
);

2. Makalelerinizi Listeleme

const response = await fetch(
  "https://integration.seoauthor.ai/api/v1/makaleler/makalelerim",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${accessToken}`,
    },
  }
);

🎯 Makale Durumları

Makaleleriniz farklı durumlarda olabilir:

Durum ID	Durum	Açıklama
1	Beklemede	İşlem sırasında
2	İşleniyor	Makale üretiliyor
3	Tamamlandı	Makale hazır
4	Hata	İşlem başarısız

📊 Kullanım Örnekleri

Blog İçeriği Üretimi

// SEO odaklı blog postu
const blogPost = {
  baslik: "2024 SEO Trendleri: Arama Motorlarında Öne Çıkmanın Yolları",
  yazimTonu: 3, // Eğitici
  makaleBoyutu: 2, // Orta
};

Kurumsal İçerik

// Profesyonel makale
const corporateArticle = {
  baslik: "Dijital Dönüşümde Şirketlerin Karşılaştığı Zorluklar",
  yazimTonu: 1, // Profesyonel
  makaleBoyutu: 3, // Uzun
};

🔍 Filtreleme ve Arama

Makalelerinizi filtreleyebilirsiniz:

// Belirli bir konu altındaki tamamlanmış makaleleri getir
const params = new URLSearchParams({
  konuId: "123",
  durumId: "3", // Tamamlandı
  pageIndex: "0",
  pageSize: "10",
});

const response = await fetch(
  `https://integration.seoauthor.ai/api/v1/makaleler/makalelerim?${params}`,
  {
    headers: {
      Authorization: `Bearer ${accessToken}`,
    },
  }
);

📈 Performans İpuçları

Toplu İşlemler

Birden fazla makale için toplu endpoint'ini kullanın:

// 10 makaleyi aynı anda oluştur
const bulkArticles = {
  makaleler: [
    { baslik: "Makale 1" },
    { baslik: "Makale 2" },
    // ... daha fazla
  ],
  yazimTonu: 1,
  makaleBoyutu: 2,
};

Pagination

Büyük makale listelerinde pagination kullanın:

// Sayfa sayfa makale listesi
for (let page = 0; page < totalPages; page++) {
  const response = await fetch(
    `/api/v1/makaleler/makalelerim?pageIndex=${page}&pageSize=20`
  );
  // İşle...
}

💡 En İyi Uygulamalar

1. Başlık Optimizasyonu

• SEO-friendly başlıklar kullanın
• Anahtar kelimeleri dahil edin
• 60 karakteri geçmeyin

2. Ton Seçimi

• Hedef kitlenizi göz önünde bulundurun
• İçerik türüne uygun ton seçin
• Tutarlılığı koruyun

3. Boyut Planlaması

• İçeriğin amacına uygun boyut seçin
• Okuyucu dikkat süresini düşünün
• SEO gereksinimleri için yeterli uzunluk

4. Konu Organizasyonu

• İlgili makaleleri aynı konu altında toplayın
• Konu limitlerini etkin kullanın
• Düzenli konu temizliği yapın

🔗 İlgili Sayfalar

• Makale Oluşturma - Tek makale oluşturma detayları
• Toplu Makale Oluşturma - Toplu işlemler
• Makalelerim - Makale listeleme ve filtreleme
• Yazım Tonları - Mevcut tonlar
• Makale Boyutları - Boyut seçenekleri

İpucu

Makale üretimi işlemlerinizi optimize etmek için toplu endpoint'leri ve uygun pagination stratejilerini kullanın.

Bilgi

Makaleleriniz oluşturulduktan sonra düzenlenemez. Bu nedenle başlık, ton ve boyut seçimlerinizi dikkatli yapın.

Dikkat

Makale üretimi hesap bakiyenizden düşer. İşlem yapmadan önce mevcut bakiyenizi kontrol etmeyi unutmayın.