Sayt API bağlantı testi uğursuz oldu

Sayt API-si SEOAsist-ə özünüz hazırladığınız sayta düzəlişlər, məzmun və llms.txt göndərməyə imkan verir. Test connection (Bağlantını test et) düyməsi saytınızın /manifest sonluğunu imzalanmış sorğu ilə çağırır. Test uğursuz olarsa, bağlantı Error (Xəta) statusunda qalır və heç nə göndərilmir.

#Simptomlar

Saytın Fix channels (Düzəliş kanalları) sekmesindəki Sayt API kartında “Test failed: …” görünür. İki nöqtədən sonrakı mətn səbəbi bildirir:

#Həlli

1. 401 / 403: Paneldəki token saytınızın SEOASIST_SITE_TOKEN mühit dəyişəni ilə dəqiq üst-üstə düşməlidir. Dəyişəni təyin etdikdən sonra saytı yenidən başladın. Tokeni itirmisinizsə, New token (Yeni token) yaradın; köhnəsi dərhal fəaliyyətini dayandırır.
2. Apache serverində, server Authorization başlığını PHP-yə ötürməyə bilər. Bu sətri .htaccess faylınıza əlavə edin: SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
3. İmza xətaları: İmza HMAC-SHA256(token, "<timestamp>.<raw body>") şəklindədir. GET sorğuları üçün body boş olur. 300 saniyədən köhnə vaxt göstəriciləri (timestamp) rədd edilir, buna görə server saatı doğru olmalıdır.
4. 404: Sonluqların ümumi kökünü API base URL (məsələn, https://example.com/api/seoasist) kimi daxil edin. /manifest əlavə etməyin; SEOAsist onu avtomatik sonuna birbirləşdirir. Dəyişdikdən sonra Save URL (URL-i saxla) düyməsini sıxın.
5. Yönləndirmələr: Sayt API-si heç vaxt yönləndirmə etməməlidir. Xəta mətnindəki son ünvanı (məsələn, https:// və ya www ilə olan) API base URL kimi saxlayın.
6. Taymoutlar: Saytın ictimai internetdən əlçatan olduğuna əmin olun. Lokal və daxili şəbəkə ünvanları rədd edilir. Fayrvol və bot mühafizəsi SEOAsist sorğularını bloklamamalıdır.
7. Manifest: /manifest sonluğu {"spec":"seoasist-site-api/1","capabilities":["rules","content","files"]} kimi JSON qaytarmalıdır. Yalnız faktiki hazırladığınız imkanları göstərin. Çoxdilli saytda isteğe bağlı "locales":["tr","en"] sahəsi ilə dəstəklədiyiniz dilləri siyahıya alın.
8. Yenidən Test connection (Bağlantını test et) düyməsini sıxın. Test keçdikdən sonra gözləyən qaydalar dərhal göndərilir.

#Hələ də işləmir?

#Test uğurla keçdi, bəs qaydalar niyə səhifədə görünmür?

Test yalnız /manifest sonluğunu yoxlayır. Səhifə render olunarkən qaydaların serverdə tətbiq edilməsi kodunuzdan asılıdır. Kartda “last push … rules” görünürsə, qaydalar saytınıza çatıb. Kodunuzu Site API reference sənədi ilə müqayisə edin.

#Tərcümə edilmiş yazı “Not published, language mismatch” səbəbilə saxlanılır. Niyə?

Sayt API-si yazıları yalnız saytın dəstəklədiyi dillərdə qəbul edir: təyin etmisinizsə Site languages siyahısı, əks halda əsas dil və /manifest-in bildirdiyi locales. Dili manifestdəki locales siyahısına (və ya saytın dil siyahısına) əlavə edin; SEOAsist yazını saxlamazdan əvvəl manifesti bir dəfə yenidən oxuyur, buna görə yenidən dərc etmək kikayətdir. Baxın: Site API setup.

#Göndərmə “This site is outside your CoSuite site allowance; it is read-only.” xətası ilə uğursuz olur.

Bu yalnız CoSuite vasitəsilə ödəniş edən təşkilatlarda baş verir: CoSuite sayt limitindən yuxarı olan saytlar oxunaqlı qalır, lakin dəyişdirilə bilməz. CoSuite-də sayt limitini artırın və ya başqa saytı silin. Öz planı üçün ödəniş edən təşkilatlar bu xətanı heç vaxt görmür.

#Sıfırdan qurmaq istəyirəm. Haradan başlamalıyam?

Kartdan Setup prompt mətni kopyalayın və onu AI kodlaşdırma köməkçisinə və ya layihəniz üzərində işləyən tərtibatçıya verin. Addımlar üçün baxın: Site API setup.