Backlink aracım hiçbir şey döndürmedi: bir hata tablosu
Aracınız, hata yönetimi kadar sakin olur. Aşağıda, gerçekten gerçekleşen hatalar, kesin nedenler ve bir yeniden denemenin mantıklı olup olmadığı yer alıyor.

Çoğu durumu kapsayan kural
Ağ hatalarını yeniden deneyin. 401 veya 402'yi asla yeniden denemeyin. Birincisi saniyeler içinde düzelir; ikincisi bir insan müdahalesi gerektirir ve üzerine gitmek sadece loglarınızı doldurur.
Her JSON yanıtı bir ok alanı taşır ve kimlik doğrulaması yapılanlar, çağrı maliyeti ve kalan bakiye ile birlikte _credits ekler. HTTP durumu iyi görünse bile gövdedeki ok değerini kontrol edin.
Aşağıdaki yeniden deneme zamanlamaları mühendislik tavsiyesidir, belgelenmiş limitler değildir. Sahip olduğumuz API belgeleri bir hız sınırı yayınlamıyor, bu yüzden kendi üst sınırınızı oluşturun ve onu makul tutun.
Neden 401 ve 402 yeniden denenmez
401 bir anahtar sorunudur ve 402 bir bakiye sorunudur. İkisi de iki deneme arasında bir saniye beklemesiyle kendiliğinden düzelmez, bu yüzden yeniden deneme loglarınıza sadece gürültü ekler.
Beklemek de 402'yi düzeltmez. Bakiye, biri hesap sayfasından yükleme yapana kadar aynı yerde kalır, bu yüzden tek faydalı tepki, net bir mesaj ve bütçeden sorumlu kişiye bir uyarıdır.
401, başlığı veya anahtar parametresini gözden geçirmeyi ve anahtarın değiştirilmediğinden emin olmayı gerektirir. Aynı yanlış anahtarı birkaç kez yeniden denemek hiçbir şey ispatlamaz.
Geçersiz bir anahtar ve boş bir bakiye, kontrol panelinizde de farklı görünür. Bunları ayrı uyarılara koyun, böylece yükleme yapan kişi bir anahtar yazım hatasıyla uyandırılmaz ve anahtarları döndüren kişi bakiye nedeniyle çağrılmaz.
Ağ hataları ve geri çekilme
Bir zaman aşımı veya bağlantı sıfırlaması kendi kendine düzelebilir, bu yüzden bunlar başka bir deneme için değer olan tek durumlardır. 1, 2, 4 ve ardından 8 saniye bekleyin, biraz gürültü ekleyin ve dördüncü denemeden sonra durun.
Bu zamanlamalar bir tavsiyedir, belgelenmiş bir limit değildir. Kendi üst sınırınızı koruyun, her yeniden denemeyi günlüğe kaydedin ve yeniden denemeler arttığında uyarı verin, çünkü artan bir yeniden deneme oranı genellikle bir üst sistem sorununun ilk işaretidir.
Zaman aşımını tarafınızda açıkça, adlandırılmış bir sabit ile tutun. Kütüphane yükseltmesiyle değişen örtük bir varsayılan, günlük bir işin yalnızca bir makinede başarısız olmasının yaygın nedenidir.
Başarısızlık oranının yanı sıra üst sistem yanıt süresine de dikkat edin. Başarısız olmayan yavaş bir yanıt bile çalışanlarınızı meşgul edebilir ve bir yeniden deneme döngüsü bu yavaşlamayı daha da kötüleştirir.
Belirti, neden, yanıt
| Belirti | Neden | Yeniden deneme? | Ne yapılmalı |
|---|---|---|---|
| HTTP 401 | Anahtar eksik, yanlış yazılmış veya iptal edilmiş | Hayır | Başlığı veya key= değerini kontrol edin, ardından hesap sayfasını |
| HTTP 402 | Kredi tükendi | Hayır | Hesap sayfasından USDT (TRC-20) ile yükleme yapın; aynı anahtar devam eder |
ok değeri HTTP 200'de doğru değil | Kötü parametre, örneğin alan adı yerine URL | Hayır | Girdiyi doğrulayın; example.com gönderin, https://example.com/page değil |
| Zaman aşımı veya bağlantı sıfırlaması | Ağ veya üst sistem hatası | Evet, 3 ila 4 kez | Gürültü ile 1, 2, 4, 8 saniye geri çekilme |
| Yeni bir site için boş sonuç | Henüz dizine eklenmedi; yenileme aylıktır | Hayır | Dizin tarihini göstererek "henüz dizine eklenmedi" mesajını gösterin |
| Sayı başka bir araçtan farklı | Farklı indeks ve farklı DR formülü | Hayır | Trendleri tek bir araç içinde karşılaştırın, DR referansı görün |
| Satırlar 50.000'de sona erer | Sayfalama üst sınırı | Hayır | Sayfalama notlarına bakın |
| Bakiye planlandığından daha hızlı düşüyor | Döngü içindeki ücretli eylem veya sıcak bir yolda 3 kredi gerektiren çağrı | n/a | _credits'i günlüğe kaydedin, eylemleri beyaz listeye alın |
Kodunuzu suçlamadan önce, başarısız olan URL'yi aynı anahtarla cURL'e yapıştırın. Orada çalışırsa hata istemcinizdedir. Orada da başarısız olursa cevap tabloda yer alır. Bu kontrol, herhangi bir günlük aramasından daha fazla bilet çözmüştür.
Bir hata ayıklama çalışması, sırayla
- 1
curl ile yeniden üretin
Başarısız olan URL'yi uygulamanızdan çıkarın ve aynı anahtarla elle çalıştırın. curl çalışıyorsa, sorun kodunuzdadır.
- 2
Ücretsiz bir eylem deneyin
Aynı etki alanındaki
overviewanahtar gerektirmez. Yanıt veriyorsa, indeks iyidir ve sorun kimlik doğrulama veya kredide yatmaktadır. - 3
Bakiyeyi okuyun
Bir 402 belirsiz değildir, ancak ücretsiz bir başarılı çağrıdan sonra başarısız olan ücretli çağrı genellikle kredi veya anahtardaki bir yazım hatasına işaret eder.
- 4
Girdiyi kontrol edin
Küçük harf, şema yok, yol yok, son nokta yok. Çoğu
okhatası burada biter.

Çağrıdan önce etki alanını normalize edin
Çoğu başarısız çağrı, ağda değil girdi kutusunda başlar. Kullanıcılar her şeyi yapıştırır ve kodunuzun bunu API görmeden önce çıplak bir etki alanına dönüştürmesi gerekir.
Şemayı ve yolu kaldırın
Şemayı, herhangi bir yolu ve sorgu dizesini kaldırın. Yapıştırılmış bir makale adresi ana makineye dönüşür ve yalnızca ana makine yukarı akışa gider.
Ana makineyi de küçük harfe çevirin. Temizlemeyi tek bir işlevde tutun, böylece aynı kural formda, toplu işte ve testlerde çalışır.
Temizlemeyi beş veya altı gerçek yapıştırılmış girdiyle test edin, bunlardan biri son eğik çizgi içeren ve diğeri sorgu dizesi içeren olsun. Bu durumlar, temiz bir örneğin asla göstermeyeceği hataları ortaya çıkarır.
www. ile ne yapılacağına dair bir kez karar verin
www. için bir kural seçin ve bunu tek bir işlevde uygulayın, böylece aynı site iki farklı yazılış altında asla aranmaz.
Kuralı işlevin yanına yazın. Yabancı bir www ile karşılaşan sonraki geliştirici, ikinci bir görüş yerine kararı bulacaktır.
Hangi kuralı seçerseniz seçin, bunu tek bir dosyada tutun ve bunun için bir test yazın. Test, kararın kaydıdır ve kısadır.
Bir etki alanı olamayacak olanları reddedin
Boşluk veya boş etiketler içeren girdileri reddedin ve formda kısa bir mesaj gösterin. Reddedilen bir dizin hiçbir şeyi maliyetmez, kötü olan ise başarısız bir çağrı ve kafa karışıklığına neden olur.
Son noktalar tuhaf bir durumdur. Ana makinenin sonundaki birini kaldırın ve diğer her şeyi geçersiz kabul edin.
Reddetmeyi, kaybolan bir bildirim yerine alanın yanında gösterin. Yanlış olanı görebilen bir kullanıcı bunu bir denemede düzeltir.
Arayüzde ham bir yukarı akış hatası asla yazdırmayın. 401 ve 402'yi genel bir "servis kullanılamıyor" ile eşleyin ve detayı kendi günlüğünüze ve bir uyarıya gönderin. Ziyaretçiler bakiyenizi düzeltemez ve mesaj aracınızın bozuk görünmesine neden olur.

Boş sonuçlar ve indeks yaşı
Birisi formunuza 'check my backlink' yazdığında ve hiçbir şey alamadığında, boş bir yanıt her zaman bir hata değildir. Bu genellikle etki alanının yeni, çok küçük veya henüz indekse alınmamış olduğu anlamına gelir ve ekran bunun hangisi olduğunu söylemelidir.
Tamamen yeni bir site
Geçen hafta başlatılan bir sitenin indekste henüz referans veren etki alanları olmayabilir. 'Henüz indekslenmedi' mesajını indeks tarihiyle birlikte gösterin ve çapraz kontrol için ücretsiz overview çağrısını sunun.
Bu boş yanıtı uzun süre önbelleğe almayın. Birkaç saat yeterlidir ve bir sonraki yeniden oluşturma siteyi getirebilir.
İndeksin son yeniden oluşturulma tarihini, sade kelimelerle ziyaretçiye söyleyin. Boş bir yanıtın yanındaki bir tarih, daha uzun bir mesajdan daha iyi bir açıklama sağlar.
Kendi arayüzünüzde tek satırlık bir not burada yeterlidir. Kimse canlı bir indeks beklemez ve indeks tarihinin yanındaki düz bir cümle dürüst olarak okunur.
Başka bir araçla uyuşmayan bir sayı
Farklı tarayıcılar web'in farklı dilimlerini görür. DR sayısını bir araç içindeki bir konum olarak okuyun ve formül için DR referansı bağlantısına yönlendirin.
Sayının altındaki kısa bir not, sonradan yapılan herhangi bir özürden daha fazla destek süresi tasarrufu sağlar.
İki okuma farklılık gösteriyorsa, önce referans veren etki alanı sayılarını karşılaştırın. DR formülü basittir, bu nedenle çoğu uyuşmazlık sayıya dayanır.
50.000'de duran satırlar
Bir liste tavana ulaştığında, yanıt API'nin izin verdiği şeyler için doğrudur. Kesim noktasını etiketleyin ve daha derin bir sayfaya çalışmak yerine sayfalama notları bağlantısını verin.
Bu noktadan sonraki daha derin sayfalar bir yeniden deneme değildir. Farklı bir sorgudur ve bunları bir olarak işlemek, bir döngünün saatlerce çalışmasının yoludur.
Kesim noktasını dışa aktarmada da görünür tutun, böylece bir ay sonra açılan bir elektronik tablo hala listenin sınırlandırıldığını gösterir.
Tablonun yanındaki satır sayısını göstermek, bir kesim noktasını görünür bir gerçek haline getirir. 50.000 satır gören bir okuyucu, daha dar bir soru sormayı bilir.
Yeniden deneme kodu gönderilmeden önce
- 401 ve 402 asla yeniden denenmez
- Zaman aşımı geriye doğru geri çekilme ve sabit sayıda deneme ile yeniden dener
- Her yanıt, HTTP durumu ne olursa olsun
okiçin kontrol edilir - Girdi, başarısız olduktan sonra değil, çağrıdan önce normalize edilir
- Yukarı akış hataları kendi günlüğünüze gider ve ziyaretçiler genel bir mesaj görür
- Boş bir sonuç, boş bir ekran yerine indeks tarihini gösterir
İlgili sorular
- Kullanıcılar kutuya herhangi bir URL yazabilir mi?
- Onlara izin verin, sonra kendiniz normalize edin. Şemayı, yolu, sorgu dizesini ve
www.'yi (seçerseniz) kaldırın, ana makineyi küçük harfe çevirin ve ardından API'yi çağırın. Yukarı akış çıplak bir etki alanı bekler, bu nedenle temizlenmemiş girdi, başarısız bir çağrının en yaygın nedenidir. - Başarısızlıkları önbelleğe almalı mıyım?
- İndeks yalnızca aylık olarak değiştiğinden, boş bir "indekslenmedi" sonucunu birkaç saat için önbelleğe alın. 401 veya 402'yi uzun süre asla önbelleğe almayın. Bunlar anahtar veya bakiye düzeltildiği anda temizlenir ve önbelleğe alınmış bir hata, düzeltmeyi gizler.
- Ücretsiz eylemler herhangi bir şeye mi sayılır?
- Kredi harcamazlar. Dört ücretsiz olan
domain,overview,statsvesuggest'tir. Yine de önbelleğe alın, çünkü kibar olmak hiçbir şeyi maliyetmez ve kendi gecikmenizi düşük tutar.