API v1 Hızlı Başlangıç

Burada SEOFuxx API v1'in ana uç noktalarını ve hızlıca denemeye başlayabilmen için birkaç örnek bulursun.

Temel bilgiler

• Temel URL: https://www.seofuxx.com/api/v1
• Spesifikasyon, projedeki openapi.yaml dosyasıdır
• Birçok uç nokta application/x-www-form-urlencoded bekler

Ana uç noktalar

• POST /account: ana veriler ve profil işlemleri
• POST /password: şifreyi güncelle
• POST /domains-projekte: alan adını, anahtar kelimeleri ve otomatik taramayı kaydet
• POST /filemerger: CSS/JS dosyalarını analiz et veya birleştir
• POST /favicon: yüklenen görselden favicon oluştur
• POST /favicon/ai-image: yapay zekâ ile görsel oluştur
• POST /favicon/from-ai: yapay zekâ görselinden favicon oluştur
• GET /ai-visibility: AI Visibility değerlerini oku (API anahtarı ile)
• POST /api-keys: API anahtarlarını oluştur, listele ve iptal et

Örnek: File Merger ile analiz

curl -X POST "https://www.seofuxx.com/api/v1/filemerger" \
  -d "action=analyze" \
  -d "domain=https://example.com"

Örnek: File Merger ile birleştirme

curl -X POST "https://www.seofuxx.com/api/v1/filemerger" \
  -d "action=merge" \
  -d "domain=https://example.com" \
  -d "jsfiles[]=/assets/js/app.js" \
  -d "cssfiles[]=/assets/css/app.css" \
  -d "shrink=1"

Kimlik doğrulama

Çoğu uç nokta etkin bir oturuma bağlıdır, yani giriş yapmış olman gerekir. Örneğin account, password, domains-projekte ve filemerger için bu geçerlidir. Bu yüzden yukarıdaki örnekler yalnızca giriş yapılmış bir oturumun çerezi ile çalışır.

Otomatik istekler için API anahtarları vardır. Bunları hesabında, API anahtarları sekmesinde oluşturursun. Anahtar yalnızca bir kez düz metin olarak gösterilir, o yüzden hemen kopyala. Kaybedersen ya da kötüye kullanıldığından şüphelenirsen anahtarı aynı yerden iptal edersin. Anahtarla birlikte Authorization: Bearer sfx_... başlığını gönderirsin; örneğin GET /ai-visibility (bkz. AI Visibility Takibi) ve MCP uç noktası için.

Hata kodları

• 400: geçersiz veya eksik parametreler
• 401: giriş yapılmamış
• 403: erişime izin yok
• 429: sınıra ulaşıldı, örneğin hesapsız analizlerde
• 500: iç hata

Tüm alan listesi ve yanıt şemaları openapi.yaml içinde yer alır; ayrıntılar için en iyi başvuru yeri orasıdır.