Yandex Webmaster’daki IndexNow API istek hataları genellikle yanlış anahtar yerleşimi, yanlış yorumlanmış durum kodları veya kısıtlayıcı kapsam tanımları gibi yapılandırma hatalarından kaynaklanır. Bir API çağrısı bir hata döndürdüğünde, teşhis süreci sunucunun doğrulama dosyasını sunma yeteneğini kontrol etmeyi ve JSON yükünün gerekli yapıyı takip ettiğinden emin olmayı içerir. Bu bileşenleri izole ederek, arama motoru iletişimini geri yükleyebilir ve sayfalarınız için doğru dizin durumunu koruyabilirsiniz.
IndexNow anahtarım neden doğrulanamıyor?
Doğrulama hataları genellikle arama motorunun anahtar dosyanızı okuyamadığını gösterir. Dosya, fazladan karakterler, HTML etiketleri veya biçimlendirme olmadan yalnızca anahtar dizesini içermelidir. Sunucunuz anahtar dosyası yoluna erişirken 404 hatası döndürürse, API isteği yükten bağımsız olarak hemen başarısız olur. Dosyanın text/plain içerik türüyle sunulduğundan emin olmak için sunucunun yanıt başlıklarını kontrol etmenizi öneririz.
Ayrıca, karakter kodlaması başarılı doğrulamada önemli bir rol oynar. Dosya UTF-8 kodlamasıyla kaydedilmelidir. Sunucunuz bir Byte Order Mark (BOM) veya gizli boşluk karakterleri eklerse, anahtar dizesi beklenen değerle eşleşmeyebilir. Çıktının tam olarak beklediğiniz gibi olduğundan emin olmak için dosyayı her zaman bir tarayıcı veya curl gibi bir komut satırı aracı aracılığıyla manuel olarak kontrol edin.
- Dosyanın UTF-8 ile kodlandığını ve yalnızca anahtar dizesini içerdiğini doğrulayın.
- Dosya adının anahtar dizesiyle tam olarak eşleştiğinden emin olun (örneğin, key-123.txt).
- Dosyanın tanımlanan keyLocation’da herkese açık olarak erişilebilir olduğunu onaylayın.
- Anahtar uzunluğunun 8 ile 128 karakter arasında olduğunu kontrol edin.
- Dosya çıktısından herhangi bir HTML sarmalayıcıyı veya sunucu tarafı banner’larını kaldırın.
API’den gelen HTTP durum kodları nasıl yorumlanır?
HTTP yanıt kodları, API istekleriniz için birincil geri bildirim döngüsü görevi görür. 202 Accepted yanıtı bir hata değildir; isteğin geçerli olduğunu ve şu anda anahtar doğrulamayı beklediğini gösterir. Bu kodu alırsanız, sadece bekleyin ve URL’lerinizi göndermeye devam edin. 200 OK yanıtı, anahtarın doğrulandığını ve URL’lerin işleme kuyruğuna kabul edildiğini onaylar.
400 veya 403 gibi hatalar acil dikkat gerektirir. 400 hatası genellikle hatalı bir JSON gövdesine veya geçersiz bir keyLocation parametresine işaret eder. 403 hatası genellikle sağlanan anahtarın belirli ana bilgisayar veya dizin için URL gönderme izni olmadığını gösterir. Bu yanıtları özel betiğinizde günlüğe kaydederek, sitenizin dizine ekleme performansını etkilemeden önce sorunları yakalayabilirsiniz.
Alien Road bunu nasıl uyguluyor
Alien Road’da, kara kutu CMS eklentilerinin sınırlamalarından kaçınmak için doğrudan API entegrasyonunu tercih ediyoruz. Müşterinin yayınlama hattında, yalnızca bir sayfa oluşturulduğunda, güncellendiğinde veya silindiğinde tek bir POST isteğini tetikleyen özel kancalar oluşturuyoruz. Bu, kaynakları israf edebilecek değiştirilmemiş URL’leri gönderme riskinden kaçınırken verimlilik standartlarına uymamızı sağlar.
Ayrıca API yanıtlarını merkezi bir günlük sistemi aracılığıyla izliyoruz. Bir dizi 403 hatası tespit edersek, betiğimiz anahtar dosyası izinlerini doğrulamak için teknik ekibimizi otomatik olarak uyarır. Örneğin, yakın tarihli bir projede, sunucunun anahtar dosyasının eski bir sürümünü sunduğunu ve bunun birden fazla alt alan adında tutarsız doğrulama sonuçlarına neden olduğunu keşfettik.
Ekiplerin HTTP yanıt başlıklarını görmezden gelen otomatik eklentilere güvendikleri için zorlandıklarını sık sık görüyoruz. Kendi mantığımızı oluşturarak, 202 yanıtının doğru şekilde işlenmesini sağlıyor ve gereksiz doğrulama yeniden başlatmalarını önlüyoruz.
Alien Road SEO ekibi
Tek bir alanda birden fazla anahtar bulunabilir mi?
Evet, Yandex tek bir alanda birden fazla anahtarın kullanımını destekler. Bu özellik, bir sitenin farklı bölümlerini ayrı sistemlerle yönettiğinizde kullanışlıdır. Örneğin, ayrı bir alt dizinde barındırılan bir blog belirli bir anahtarı kullanabilirken, ana mağaza başka bir anahtar kullanabilir. Her API isteğinin o sistem için doğru keyLocation’ı açıkça işaret ettiğinden emin olmalısınız.
Birden fazla anahtar kullanırken, dizin düzeyindeki çakışmaları önlemek için bunları site kökünde tutun. Bir sistem, anahtarı tarafından izin verilen kapsamın dışına düşen URL’leri göndermeye çalışırsa, istek bir kapsam ihlali ile başarısız olur. Yanlışlıkla üzerine yazmaları veya yanlış yapılandırmaları önlemek için hangi anahtarın hangi sisteme atandığını izlemek üzere proje deposunda basit bir belge dosyası tutmanızı öneririz.
Kapsam ihlalleri nasıl çözülür?
Kapsam ihlalleri, anahtarın dizin konumu gönderilen URL’ler için çok dar olduğunda meydana gelir. Anahtar dosyanız /catalog/ gibi bir alt klasörün içine yerleştirilirse, /blog/ veya ana sayfa için URL gönderimlerini yetkilendirmez. Bunu önlemenin en güvenilir yolu, anahtar dosyasını kök dizine yerleştirmektir, bu da anahtarın tüm site yapısını kapsamasına olanak tanır.
Güvenlik veya delegasyon için kısıtlı kapsamlar kullanmanız gerekiyorsa, API isteklerinizin bu yollara kesinlikle bağlı kaldığından emin olun. Örneğin, bir ekip yalnızca /news/ bölümünü yönetiyorsa, API entegrasyonlarının yalnızca bu yol için yapılandırıldığından emin olun. Bu sınırın dışına çıkma girişimi bir hatayı tetikleyecektir. Günlüklerinizi periyodik olarak gözden geçirmek, belirli bir sistemin izin verilen kapsamının dışına düşen URL’leri göndermeye çalışıp çalışmadığını belirlemenize yardımcı olacaktır.
- Geniş kapsam için doğrulama anahtarını kök dizine yerleştirin.
- keyLocation parametresinin gerçek dosya yoluyla eşleştiğinden emin olun.
- Gönderilen URL’lerin anahtar tarafından kapsanan alan adıyla eşleştiğini kontrol edin.
- Tamamen bağımsız alt alan adları için ayrı anahtarlar kullanın.
- Kapsam sorunları için yaygın olan 403 hataları için günlükleri gözden geçirin.
Kapsam sorunları sessiz bir performans katilidir. İlk kurulum aşamasında anahtar konumunuzun tüm URL yapınızı kapsayacak kadar geniş olduğunu her zaman doğrulayın.
Alien Road SEO ekibi
Bu hafta nereden başlamalı
Bu hafta mevcut IndexNow kurulumunuzu denetleyerek başlayın. Anahtar dosyanıza bir curl isteği gerçekleştirmek ve 200 durumunu ve doğru içeriği döndürdüğünü doğrulamak için basit bir komut satırı betiği kullanın. Üçüncü taraf bir eklenti kullanıyorsanız, değiştirilmemiş sayfaları gönderip göndermediğini görmek için günlüklerini kontrol edin, çünkü bu kaynak tükenmesinin ve potansiyel API hız sınırlamasının yaygın bir nedenidir.
Günlükleriniz kalıcı hatalar gösteriyorsa, eklentiyi doğrudan bir betikle değiştirmeyi düşünün. JSON POST isteği gönderen temel bir betiğin bakımı kolaydır ve süreç üzerinde tam kontrol sağlar. Üçüncü taraf bağımlılıklarını ortadan kaldırarak, API iletişimlerinizin net bir görünümünü elde edersiniz ve gelecekteki sorunları minimum çabayla çözebilirsiniz.