Ana içeriğe geç

Hızlı Başlangıç

Bu rehber, SeoAuthor API'yi kullanmaya başlamanız için gereken temel adımları açıklamaktadır. 5 dakika içinde ilk API çağrınızı yapabileceksiniz!

📋 Gereksinimler​

API'yi kullanmaya başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  • ✅ Geçerli bir Finex hesabı
  • ✅ Email ve şifre bilgileriniz
  • ✅ HTTP istekleri yapabileceğiniz bir platform (Postman, curl, vs.)

🔑 1. Adım: Kimlik Doğrulama​

İlk olarak, API'ye erişim için authentication token'ı almanız gerekiyor.

Login Endpoint​

POST https://integration.seoauthor.ai/api/v1/auth/login
Content-Type: application/json

{
  "email": "your-email@example.com",
  "password": "your-password"
}

Örnek cURL Komutu​

curl -X POST https://integration.seoauthor.ai/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@example.com",
    "password": "your-password"
  }'

Başarılı Yanıt​

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "accessTokenExpire": 1692789600,
  "refreshToken": "def502004b8f5b..."
}
Önemli

accessToken'ı güvenli bir yerde saklayın. Bu token'ı sonraki API çağrılarında kullanacaksınız.

🎯 2. Adım: İlk API Çağrınız​

Artık token'ınız var! İlk API çağrınızı yapmaya hazırsınız. Hesap bakiyenizi kontrol edelim:

GET https://integration.seoauthor.ai/api/v1/profil/guncel-bakiye
Authorization: Bearer YOUR_ACCESS_TOKEN

Örnek JavaScript Kodu​

const accessToken = "YOUR_ACCESS_TOKEN";

fetch("https://integration.seoauthor.ai/api/v1/profil/guncel-bakiye", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
  },
})
  .then((response) => response.json())
  .then((data) => {
    console.log("Mevcut Bakiye:", data);
  })
  .catch((error) => {
    console.error("Hata:", error);
  });

📝 3. Adım: İlk Makalenizi Oluşturun​

Şimdi bir makale oluşturalım:

POST https://integration.seoauthor.ai/api/v1/makaleler/makale-olustur
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "baslik": "JavaScript ile Modern Web Geliştirme",
  "yazimTonu": 1,
  "makaleBoyutu": 2
}

Örnek Python Kodu​

import requests

url = "https://integration.seoauthor.ai/api/v1/makaleler/makale-olustur"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "baslik": "JavaScript ile Modern Web Geliştirme",
    "yazimTonu": 1,
    "makaleBoyutu": 2
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

🔄 4. Adım: Token Yenileme​

Access token'ınızın süresi dolduğunda refresh token kullanarak yeni token alabilirsiniz:

POST https://integration.seoauthor.ai/api/v1/auth/refresh
Content-Type: application/json

{
  "refreshToken": "YOUR_REFRESH_TOKEN"
}

📊 Yazım Tonları ve Makale Boyutları​

Yazım Tonlarını Listele​

GET https://integration.seoauthor.ai/api/v1/makaleler/yazim-tonlari
Authorization: Bearer YOUR_ACCESS_TOKEN

Makale Boyutlarını Listele​

GET https://integration.seoauthor.ai/api/v1/makaleler/makale-boyutları
Authorization: Bearer YOUR_ACCESS_TOKEN

🎉 Tebrikler!​

İlk API çağrılarınızı başarıyla yaptınız! Şimdi şunları yapabilirsiniz:

🆘 Yardıma İhtiyacınız mı Var?​

  • Hata Kodları: Error Codes sayfasını kontrol edin
  • Örnekler: Examples sayfasında daha fazla kod örneği bulabilirsiniz
  • Rate Limiting: API çağrı limitleri hakkında bilgi için dokümantasyonu inceleyin
Pro İpucu

API'yi test etmek için Postman gibi araçları kullanabilirsiniz. Bu, API çağrılarınızı kolayca test etmenize ve debug etmenize yardımcı olur.

Token Güvenliği
  • Access token'ları hiçbir zaman client-side kodda saklamayın
  • Token'ları environment variables olarak kullanın
  • Refresh token'ları güvenli bir şekilde saklayın