SEOAsist Docs
Sorun gidermeGüncellendi: 2026-10-16

Site API bağlantı testi başarısız

“Test başarısız” hatasında token, imza, yanlış adres, yönlendirme, zaman aşımı ve Apache'nin Authorization başlığını silmesi gibi nedenleri bul ve düzelt.

Bu ekranı panelde aç

Site API, kendi kodladığın siteye SEOAsist'in düzeltme, içerik ve llms.txt göndermesini sağlar. Bağlantıyı test et düğmesi sitendeki /manifest adresini imzalı bir istekle çağırır. Test geçmezse bağlantı Hata durumunda kalır ve hiçbir şey gönderilmez.

Belirtiler

Sitenin Düzeltme kanalları sekmesindeki Site API kartında “Test başarısız: …” yazar. Hatadan sonraki kısım nedeni söyler:

Hata metniAnlamı
token rejected / unauthorized (401, 403)Token ya da imza sitende doğrulanmadı
endpoint not found (is the Site API installed at this URL?) (404)Adreste Site API yok
redirect to … (use the final API URL)Adres başka bir adrese yönlendiriyor
timeoutSite 25 saniye içinde cevap vermedi
non-JSON responseCevap JSON değil (ör. bir HTML sayfası)
unexpected manifest (spec "…")/manifest cevabında spec alanı yanlış

Çözüm

  1. 401 / 403: Paneldeki token sitenin SEOASIST_SITE_TOKEN ortam değişkeninde birebir aynı olmalı. Değişkeni ekledikten sonra siteyi yeniden başlat. Token'ı kaybettiysen Yeni token üret; eski token hemen geçersiz olur.
  2. Apache kullanıyorsan sunucu Authorization başlığını PHP'ye iletmeyebilir. .htaccess dosyana şu satırı ekle: SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
  3. İmza hatası: İmza HMAC-SHA256(token, "<zaman damgası>.<ham gövde>") ile hesaplanır. GET isteklerinde gövde boştur. 300 saniyeden eski zaman damgası reddedilir, bu yüzden sunucunun saati doğru olmalı.
  4. 404: API taban adresi alanına uç noktaların ortak kökünü yaz (ör. https://ornek.com/api/seoasist). /manifest kısmını ekleme; SEOAsist bunu kendisi ekler. Adresi değiştirince Adresi kaydet'e bas.
  5. Yönlendirme: Site API hiç yönlendirme yapmamalı. Hata metnindeki son adresi (ör. https:// ya da www ile) API taban adresi olarak kaydet.
  6. Zaman aşımı: Sitenin herkese açık internetten erişilebilir olduğunu kontrol et. Yerel ve iç ağ adresleri kabul edilmez. Güvenlik duvarı ya da bot koruması SEOAsist'in isteklerini engellemesin.
  7. Manifest: /manifest şu yapıda JSON dönmeli: {"spec":"seoasist-site-api/1","capabilities":["rules","content","files"]}. Yalnızca gerçekten yazdığın yetenekleri listele.
  8. Bağlantıyı test et'e tekrar bas. Başarılı olunca bekleyen kurallar hemen gönderilir.
tip

Geliştirici kılavuzunun Test sekmesindeki curl komutu aynı imzalı isteği terminalden yapar. Panelde denemeden önce sorunu orada görebilirsin.

Hâlâ olmuyorsa

Test geçti ama kurallar sayfada görünmüyor, neden?

Test yalnızca /manifest adresini dener. Kuralları sayfa render edilirken sunucu tarafında uygulamak senin kodunun işidir. Kartta “son gönderim … kural” yazıyorsa kurallar siteye ulaşmıştır. Uygulama kodunu Site API referansı ile karşılaştır.

Kurulumu sıfırdan yapmak istiyorum, nereden başlamalıyım?

Karttaki Kurulum promptunu kopyala ve projende çalışan AI kod asistanına ya da geliştiricine ver. Adımlar için Site API kurulumu yazısına bak.

İlgili yazılar

Bu yazı işine yaradı mı?
Aradığını bulamadın mı?
Sorunu yaz, ekibimiz e-postayla dönsün.
Bize yaz