Baidu Search Resource Platform API gönderim hatalarını düzeltmek, site kimlik doğrulama belirtecinizi doğrulamak ve sunucunuzun her istenen URL için geçerli HTTP durum kodları döndürdüğünden emin olmakla başlar. API bir hata döndürdüğünde, neden genellikle gönderilen URL listesi ile hesap panonuzda doğrulanan site özelliği arasındaki uyumsuzluktur. API aracılığıyla gönderilen her URL’nin erişilebilir olduğunu ve ilk platform kurulumunuz sırasında verilen alan adı izinleriyle uyumlu olduğunu doğrulamanız gerekir.
Birçok site sahibi için API, yeni veya güncellenmiş içeriği arama motoruna bildirmenin birincil yoludur. Ancak sistem, veri bütünlüğü konusunda katıdır. Sunucunuz gönderilen bir URL için 200’den farklı bir durum kodu döndürürse veya kimlik doğrulama belirtecinin süresi dolmuşsa, API tüm grubu reddeder. Bu hataları gidermek, sunucu günlüklerinizin ve API entegrasyon betiklerinizin sistematik bir incelemesini gerektirir.
API gönderim hatalarına ne sebep olur?
Çoğu gönderim hatası üç yaygın sorundan kaynaklanır: kimlik doğrulama hataları, kota tükenmesi veya hatalı URL sözdizimi. Baidu, sitenizin otoritesine ve doğrulama düzeyine bağlı olarak günde gönderebileceğiniz URL sayısına katı sınırlar koyar. Bu günlük kotaları aşarsanız, API genellikle site mülkünüz için izin verilen maksimum kapasiteye ulaştığınızı belirten özel bir hata kodu döndürür.
Ayrıca, sağlanan URL yapısı protokolle eşleşmiyorsa, örneğin site HTTPS olarak doğrulandığı halde HTTP bağlantıları gönderiliyorsa, sistem isteği hemen reddeder. Eşleşmeyen protokoller, bir siteyi güvenli bir bağlantıya taşırken sık karşılaşılan bir sorundur. API betiğinin veritabanınızdan artık aktif olmayan eski sürümleri değil, doğru kanonik URL’leri çektiğinden emin olmalısınız.
Bir diğer yaygın hata kaynağı da engellenmiş URL’lerin dahil edilmesidir. robots.txt dosyanız bir klasöre erişimi kısıtlıyorsa, ancak betiğiniz aynı klasörden URL’ler göndermeye çalışıyorsa, platform bunları geçersiz veya erişilemez olarak işaretleyecektir. Gönderim listenizi robots.txt yapılandırmanıza göre düzenli olarak denetlemek, gereksiz API reddetmelerini önlemek için temel bir görevdir.
Belirli hata kodları nasıl tanımlanır ve çözülür?
- 401 Unauthorized: Baidu Search Resource Platform panelindeki Site Belirtecinizi doğrulayın. Bu genellikle belirteç değiştirildiğinde veya hesap izinleri değiştirildiğinde olur.
- 403 Forbidden: Sunucu IP’nizin Baidu tarayıcı isteklerini engellemediğinden emin olun. Platformun IP aralıklarının beyaz listede olduğundan emin olmak için güvenlik duvarı ayarlarınızı kontrol edin.
- 404 Not Found: URL’nin aktif olduğunu ve ölü bağlantı sayfasına yönlendirilmediğini kontrol edin. Ölü bağlantılar göndermek sitenizin itibarına zarar verir.
- 429 Too Many Requests: Günlük API gönderim kotanızı gözden geçirin ve betik sıklığınızı izin verilen sınırlar içinde kalacak şekilde ayarlayın.
403 hatasıyla karşılaştığınızda, bu genellikle API’nin kendisiyle ilgili bir sorun değil, barındırma tarafınızdaki bir güvenlik önlemidir. Sunucunuz otomatik botları engellemek için yapılandırılmışsa, API el sıkışmasını yanlışlıkla durdurabilir. Baidu’nun sunucu isteklerinin engellenip engellenmediğini görmek için WAF (Web Uygulama Güvenlik Duvarı) günlüklerinizi inceleyin ve gerekli iletişime izin vermek için kalıcı bir kural oluşturun.
429 hataları için çözüm, kodunuzda üstel geri çekilme stratejisi uygulamaktır. API’yi tüm URL’lerinizle aynı anda bombalamak yerine, gönderimleri gün içine yayın. Bu, sunucunun hesabınızı aşırı trafik nedeniyle işaretlemesini önler ve içeriğinizin istikrarlı bir hızda işlenmesini sağlar.
Doğru URL durum yönetimi neden önemlidir
Durum kodlarını yönetmek arama motoru sağlığı için esastır. Yaygın bir hata, boş veya silinmiş sayfalar için 200 OK durumu döndürmektir ki Baidu bunu yumuşak 404 olarak sınıflandırır. Bu URL’leri API aracılığıyla gönderdiğinizde, dizin için hiçbir değeri olmayan sayfalara günlük kotanızı harcarsınız. Artık mevcut olmayan sayfalar için her zaman 404 durum kodu döndürün, çünkü bu, motorun dizinini daha verimli bir şekilde yenilemesine yardımcı olur.
Siteniz bir ‘hata’ sayfası görüntülüyorsa ancak sunucu başlığı 200 döndürüyorsa, sistem sonunda bu bölümleri taramayı durduracaktır. Bu, motorun içerik yokluğunu sayfanın tarama bütçesine değmeyeceğine dair bir işaret olarak yorumlaması nedeniyle gerçekleşir. Temiz bir 404 durumu, tarayıcıya o konumu ziyaret etmeyi bırakmasını etkili bir şekilde söyler ve bunun yerine aktif, yüksek değerli sayfalarınıza odaklanmasına olanak tanır.
Ayrıca, ölü içerik için yönlendirmeler kullanmaktan kaçının. 301 yönlendirmesi taşınan sayfalar için standart olsa da, artık mantıklı bir hedefi olmayan sayfalar için kullanılması, tarayıcının ayrıştırması zor olan ‘yönlendirme zincirleri’ oluşturur. Sayfayı silmek ve 404 vermek, yaşam döngüsünün sonuna ulaşmış içeriği yönetmenin daha temiz bir yoludur.
Müşterilerin bozuk URL’ler göndererek günlük API kotalarını boşa harcadıklarını sıkça görüyoruz. Toplu gönderimler yapmadan önce site dizininizi yumuşak 404’lerden temizlemek, kaynak tasarrufu sağlayan ve dizine ekleme hızını artıran temel bir adımdır.
Alien Road SEO ekibi
Alien Road bu teknolojiyi nasıl uyguluyor
Alien Road’da, API gönderimini doğrudan dağıtım iş akışına entegre ederek müşterilerimiz için Baidu performansını yönetiyoruz. Yalnızca yüksek değerli sayfaların gönderilmesini sağlamak için site yapısını haritalayarak başlıyoruz. Ardından, her gönderimin başarı oranını izlemek için izleme araçlarımızı yapılandırıyoruz. Hatalar oluşursa, sistemimiz belirli URL’yi işaretler ve bu da geçici bir sunucu zaman aşımı mı yoksa manuel müdahale gerektiren yapısal bir sorun mu olduğunu araştırmamıza olanak tanır.
Sürecimiz, API gönderim betiğini canlıya geçmeden önce test ettiğimiz bir hazırlık ortamı oluşturmayı içerir. Kuru bir çalışma yaparak, hatalı URL’ler veya yanlış başlıklar gibi yaygın hataları canlı siteyi etkilemeden önce tanımlıyoruz. Ardından bu bulguları geliştirme ekibine bildirerek canlı gönderimin temiz ve hatasız olmasını sağlıyoruz.
Ayrıca müşterilerimiz için günlük API yanıtlarını toplayan özel bir panel tutuyoruz. Bu, bozuk bağlantılar oluşturan belirli bir şablon gibi kalıpları görmemizi ve kök nedeni düzeltmemizi sağlar. Bizim için amaç, API’ye yapılan her isteğin sistemi hatalarla doldurmak yerine sitenin görünürlüğüne katkıda bulunmasını sağlamaktır.
Otomatik gönderimlerde yaygın tuzaklar
Otomasyon yararlıdır ancak dizin kirliliğini önlemek için gözetim gerektirir. Birçok betik, düşük kaliteli filtre sayfaları veya dahili arama sonuçları dahil olmak üzere oluşturulan her URL’yi gönderir. Bu uygulama dizininizi, sitenizin kalite puanını düşürebilecek gürültüyle doldurur. Herhangi bir API çağrısı yapılmadan önce katı bir filtreleme süreci öneriyoruz.
- Benzersiz içerik eklemeyen dinamik parametre sayfalarını filtreleyin.
- Yinelenen dizine eklemeyi önlemek için tüm URL’leri gönderimden önce kanonize edin.
- 5xx hataları döndüren sayfaları tanımlamak için sunucu günlüklerini denetleyin.
- Günlük kota tahsisinizde yeni içeriğe mevcut sayfalardan öncelik verin.
Bir diğer sık karşılaşılan hata, gönderilen URL’lere oturum kimliklerinin veya izleme parametrelerinin dahil edilmesidir. Bu parametreler her kullanıcı oturumu için değişir ve aynı içerik için binlerce benzersiz URL oluşturur. Bunlar API’ye gönderilirse, motor yinelenen sürümleri dizine eklemeye çalışarak zaman kaybeder, bu da teknik kaynaklarınızın kötü bir kullanımıdır.
Son olarak, site haritanızın ve API gönderim listelerinizin senkronize olduğundan emin olun. Site haritanız API gönderiminizden farklı bir URL kümesi içeriyorsa, bu motora çelişkili sinyaller gönderir. Tarayıcının izlemesi için net bir yol tutmak adına bu iki yöntemi tutarlı tutuyoruz.
Otomatik gönderimler ‘ayarla ve unut’ görevi değildir. Platform tarafından sağlanan hata günlüklerini izlemek, çabalarınızın teknik borca neden olmak yerine görünürlüğünüze gerçekten yardımcı olduğundan emin olmanın tek yoludur.
Alien Road SEO ekibi
Bu hafta nereden başlamalı
Baidu Search Resource Platform hesabınıza giriş yaparak ve ‘Data Submission’ sekmesi altındaki ‘API Submission’ bölümünü kontrol ederek başlayın. Son yedi gün içinde hangi URL’lerin reddedildiğini görmek için ‘Error Records’ raporunu inceleyin. Bu listeyi site haritanızı temizlemek ve API betiğinizi bu belirli hata kalıplarını hariç tutacak şekilde ayarlamak için kullanın. Bu temel sorunları ele alarak, gelecekteki gönderimlerinizin kesintisiz işlenmesini sağlarsınız.
Birikmiş işleri temizledikten sonra, hata günlüğünü her Cuma kontrol etmek için tekrarlayan bir takvim hatırlatıcısı ayarlayın. Bu basit alışkanlık, küçük teknik sorunların daha büyük dizine ekleme sorunlarına dönüşmesini önler. Tutarlı bakım, önde kalmanın en güvenilir yoludur.