IndexNow API istek referansı, geliştiricilere URL güncellemelerini doğrudan katılımcı arama motorlarına iletmek için gereken kesin teknik özellikleri sağlar. Güncellenmiş URL’lerinizi ve bir doğrulama anahtarını içeren basit bir HTTP POST isteği göndererek, botları yeni veya değiştirilmiş içerik hakkında anında bilgilendirirsiniz. Bu mekanizma, geleneksel keşif gecikmelerini atlar ve web sayfalarınızın arama sonuçlarına daha hızlı dahil edilmesini sağlar.
Bu protokolün uygulanması, yük formatlamasına, uç nokta seçimine ve sunucu yapılandırmasına dikkat edilmesini gerektirir. Doğru yönetildiğinde, otomatik gönderimler yeni envanterin, makalelerin veya yapısal değişikliklerin arama motoru sonuç sayfalarında görünmesi için gereken süreyi azaltır. Geliştiriciler, geçerli JSON yüklerini nasıl oluşturacaklarını, sunucu yanıtlarını nasıl yöneteceklerini ve indeksleme hatalarına neden olan yaygın tuzaklardan nasıl kaçınacaklarını anlamalıdır.
IndexNow API isteğinin temel yapısı nedir?
Bir IndexNow isteği, HTTPS aracılığıyla uç nokta sunucusuna gönderilen basit bir JSON yüküne dayanır. İstek gövdesi, ana bilgisayar alan adınızı, oluşturduğunuz anahtarınızı, bu anahtar dosyasının sunucunuzdaki konumunu ve değiştirilmiş veya oluşturulmuş URL’lerden oluşan bir diziyi içermelidir. Yükü doğru yapılandırmak sözdizimi hatalarını önler ve alıcı sunucunun toplu güncellemelerinizi reddetmeden işlemesini sağlar.
Doğrulama anahtarını web sitenizin kök dizininde bir metin dosyası olarak barındırmalısınız. Dosya adı anahtar dizisinin kendisiyle eşleşmeli ve dosya içeriği yalnızca bu anahtarı içermelidir. Arama motorları, alan adı sahibinin bu belirli URL’lerin gönderilmesine gerçekten izin verdiğini doğrulamak için bu dosyayı alır. Bu doğrulama adımı olmadan, herhangi bir dış taraf sizin adınıza kötü niyetli veya spam URL’ler gönderebilir, bu da anahtarın doğru yerleştirilmesini katı bir güvenlik gereksinimi haline getirir.
İstek yükünü oluştururken, listedeki her URL’nin tam nitelikli olduğundan ve genel siteniz tarafından kullanılan tam şemayla eşleştiğinden emin olun. HTTP ve HTTPS’i karıştırmak veya kanonik adresinizin bir parçası olduklarında www öneklerini atlamak, alıcı motorun geçersiz girişleri işleme kuyruğundan çıkarmasına neden olur. Site haritanız, kanonik etiketleriniz ve gönderilen URL’ler arasında katı bir tutarlılık sağlamak sorunsuz işlemeyi garanti eder.
JSON yükündeki gerekli parametreler
- host: Protokol önekleri olmayan web sitenizin alan adı.
- key: Barındırılan doğrulama dosyanızın adıyla eşleşen alfanümerik dize.
- keyLocation: Anahtar metin dosyanızın bulunduğu yere işaret eden tam URL.
- urlList: Eklenen, güncellenen veya silinen tam, nitelikli URL’lerden oluşan bir dizi.
Kimlik doğrulama ve anahtar doğrulamasını nasıl yönetirsiniz?
IndexNow aracılığıyla kimlik doğrulama, dosya tabanlı sahiplik kontrollerini kullanarak karmaşık token değişimlerinden kaçınır. Bir arama motoru yeni bir anahtarla ilk API isteğinizi aldığında, o anahtarla eşleşen metin dosyasını indirmek için sitenizin kök dizinini otomatik olarak tarar. Dosyanın içindeki anahtar, API yükünüzde gönderilen anahtarla eşleşirse, o ana bilgisayardan gelen sonraki tüm istekler kabul edilir.
Kesintisiz hizmeti sürdürmek için sunucu yöneticileri, güvenlik duvarlarının, hotlink korumalarının veya içerik dağıtım ağlarının doğrulama dosyasını hedefleyen istekleri engellemediğinden emin olmalıdır. Bir bot sahipliği doğrulamaya çalışırken bir meydan okuma sayfası, JavaScript yönlendirmesi veya eksik bir dosyayla karşılaşırsa, temel yönlendirme sorunu kalıcı olarak çözülene kadar tüm URL gönderimleri reddedilecektir.
Ayrıca, güvenlik anahtarınızı kasten döndürmediğiniz sürece, entegrasyon aktif olduktan sonra doğrulama dosyasını asla değiştirmemelisiniz. Anahtarınızı değiştirmeye karar verirseniz, yeni metin dosyasını yüklemeli, API yük parametrelerinizi aynı anda güncellemeli ve eski metin dosyasını yalnızca yeni anahtarın alıcı sunucular tarafından başarıyla doğrulandığını onayladıktan sonra güvenli bir şekilde kaldırmalısınız.
Anahtar dosyalarının herkese açık olduğundan ve agresif önbelleğe alma kuralları veya güvenlik eklentileri tarafından engellenmediğinden emin olmak için müşteri sunucularını sık sık denetliyoruz. Doğrulama dosyası 403 veya 404 durumu döndürürse, API yol geri yüklenene kadar tüm URL gönderimlerini reddeder.
Alien Road SEO ekibi
API uygulaması sırasında hangi yaygın hatalar oluşur?
Geliştiriciler, urlList dizisi içinde hatalı biçimlendirilmiş URL’ler gönderirken veya HTTPS yerine HTTP kullanırken sıklıkla sorunlarla karşılaşırlar. Bir diğer sık yapılan hata, gönderilen yolların arama motoru tarafından indekslenen kanonik sürümlerle eşleşmediği URL normalleştirmesini içerir. Sondaki eğik çizgilerin ve parametre dizilerinin dahili site mimarinizle tam olarak eşleştiğinden emin olun.
Ayrıca, tek bir istekte aşırı büyük toplu işlemler göndermek hız sınırlarını tetikleyebilir. Büyük güncellemeleri istek başına birkaç bin URL’lik daha küçük parçalara bölün ve kararlı sunucu yanıt sürelerini korumak için bunları aralıklı gönderin. Uç noktayı tek bir yükte on binlerce URL ile aşırı yüklemek genellikle ağ geçidi zaman aşımlarına ve eksik işlemeye neden olur.
Bir diğer tehlikeli ihmal, komut dosyaları aracılığıyla gezinmeyi veya dinamik yönlendirmeleri hesaba katmamayı içerir. CMS’niz kullanıcıları nihai URL’ye ulaşmadan önce geçici hazırlama parametreleri veya oturum tanımlayıcıları aracılığıyla otomatik olarak yönlendiriyorsa, bu karmaşık yollar asla API’ye gönderilmemelidir. Bot karışıklığını ve yumuşak 404 hatalarını önlemek için gönderim dizinize yalnızca temiz, kalıcı URL’ler dahil edilmelidir.
Alien Road bu IndexNow API istek referansını nasıl uygular
Alien Road’da, müşterilerimiz için kurumsal içerik yönetim sistemlerine otomatik IndexNow göndericileri oluşturuyoruz. Teknik keşif aşamamızda, yeni bir ürün sayfası oluşturma veya mevcut bir blog gönderisini güncelleme gibi her yayınlama olayını haritalandırıyoruz. Bu yayınlama kancaları tetiklendiğinde IndexNow uç noktasına otomatik olarak bir HTTP POST isteği tetiklemek için arka uç kodunu yapılandırıyoruz.
Örneğin, yüksek frekanslı yayın yapan bir siteyi yöneten tipik bir müşteri etkileşiminde, API yanıt kodlarını izlemek için günlük kaydı mekanizmaları kuruyoruz. Geçici bir ağ zaman aşımı nedeniyle bir gönderim başarısız olursa, sistemimiz yükü ikinci bir deneme için kuyruğa alır. Bu yapılandırılmış yaklaşım, taze içeriğin yayına girdikten dakikalar sonra arama motoru indekslerine ulaşmasını garanti eder ve manuel müdahale olmadan genel organik görünürlüğü artırır.
Ayrıca, URL kuyruğunu kirletebilecek iframe içine gömülü içerik veya kararsız CGI parametreleri gibi yaygın tuzakları önlemek için müşteri sitesi altyapısını denetliyoruz. Temiz site mimarisini anlık API ping’leri ile eşleştirerek, arama motorları yapısal güncellemeleri çok daha hızlı işler ve tarama bütçesi israfından kaçınır.
IndexNow entegrasyonu için dağıtım kontrol listemiz
- Güvenli bir alfanümerik anahtar oluşturun ve metin dosyasını sunucu kök dizinine yerleştirin.
- İçerik güncellemelerinde HTTP POST isteklerini tetiklemek için CMS yayınlama kancalarını yapılandırın.
- JSON yükünü doğru host, key ve urlList parametreleriyle biçimlendirin.
- Başarısız gönderimleri erkenden yakalamak için sunucu hata günlüklerini ve API yanıt kodlarını izleyin.
URL gönderimlerini otomatikleştirmek, standart bot keşfiyle ilişkili bekleme oyununu ortadan kaldırır. Temiz site mimarisini anlık API ping’leri ile eşleştirerek, arama motorları yapısal güncellemeleri çok daha hızlı işler.
Alien Road SEO ekibi
API isteklerinizi nasıl test edebilir ve doğrulayabilirsiniz?
Kodunuzu canlı bir üretim ortamına dağıtmadan önce, cURL gibi komut satırı araçlarını kullanarak isteklerinizi test edin. Sunucunuzun 200 OK durumuyla yanıt verdiğini doğrulamak için manuel bir yük gönderin. Ayrıca, gönderilen URL’lerinizin başarıyla işlendiğini ve tarama kuyruğuna eklendiğini onaylamak için katılımcı arama motorları tarafından sağlanan web yöneticisi konsolu panolarını inceleyebilirsiniz.
Testler, motorun bunları indeksten düzgün bir şekilde çıkardığını doğrulamak için silinmiş URL’lerin gönderilmesi gibi uç durumları da içermelidir. Hazırlık aşamasında bu doğrulama kontrollerini çalıştırmak, hatalı biçimlendirilmiş JSON yüklerini, yanlış anahtar konumlarını veya ağ bloklarını canlı üretim performansını etkilemeden önce yakalamaya yardımcı olur.
Son olarak, zaman içindeki kabul oranlarını izlemek için arka uç yayınlama günlüklerinizin rutin izlemesini oluşturun. Başarılı API yanıtlarında ani bir düşüş fark ederseniz, katılımcı arama motoru uç noktalarıyla güvenilir iletişimi yeniden sağlamak için sunucu tarafındaki güvenlik duvarı yapılandırmalarını veya anahtar dosyası erişilebilirliğini derhal araştırın.