İstek Sıklığı

Bu belge aşağıdaki yöntemler için geçerlidir:

  • Update API (v4): fullHashes.find
  • Update API (v4): threatListUpdates.fetch
  • Güncelleme istekleri

    Güncelleme API'si (v4), sunucunun aşırı yüklenmesini önlemek ve optimum korumadan yararlanmak amacıyla, bir istemcinin URL kontrolleri gerçekleştirmek (fullHashes.find) veya yerel veritabanını güncellemek (threatListUpdates.fetch) için Güvenli Tarama sunucusuna ne sıklıkta istek gönderebileceği ile ilgili zaman aralıkları belirler.

    İlk veri isteği, istemci başlatıldıktan veya uyandıktan sonra 0 ile 1 dakika arasında rastgele bir aralıkta gerçekleşmelidir. Sonraki istekler yalnızca minimum bekleme süresi veya geri alma modu süre sınırı gözlemlendikten sonra gerçekleşebilir.

    Minimum bekleme süresi

    Hem fullHashes.find yanıtı hem de threatListUpdates.fetch yanıtında, istemcilerin uyması gereken bir minimumWaitDuration alanı bulunur.

    Yanıtta minimumWaitDuration alanı ayarlanmamışsa istemciler istedikleri sıklıkta güncelleme yapabilir ve istedikleri sayıda threatListUpdates veya fullHashes isteği gönderebilir.

    Yanıtta minimumWaitDuration alanı ayarlanmışsa istemciler bekleme süresinden daha sık güncelleme yapamaz. Örneğin, bir fullHashes yanıtı 1 saatlik minimum bekleme süresi içeriyorsa kullanıcı, karma ön eki yerel veritabanıyla eşleşen bir URL'yi ziyaret ediyor olsa bile istemci bu saat geçene kadar fullHashes isteği göndermemelidir. (İstemcilerin minimum bekleme süresinden daha seyrek güncelleme yapabileceğini ancak bu durumun korumayı olumsuz etkileyebileceğini unutmayın.)

    Geri yükleme modu

    Otomatik geri yükleme, hem fullHashes.find yanıtı hem de threatListUpdates.fetch yanıtı için geçerlidir.

    Başarısız bir HTTP yanıtı alan istemciler (200 OK dışındaki herhangi bir HTTP durum kodu) geri çekilme moduna girmelidir. Geri yükleme modundayken, istemcilerin sunucuya başka bir istek göndermeden önce hesaplanan süreyi beklemesi gerekir.

    İstemciler, geri alma süresini hesaplamak için aşağıdaki formülü kullanmalıdır:

    MIN((2N-1 * 15 minutes) * (RAND + 1), 24 hours)

    N, istemcinin yaşadığı art arda başarısız olan istek sayısına karşılık gelir (ilk başarısız istekten sonra N=1 ile başlar). RAND, her başarısız güncellemeden sonra seçilmesi gereken, 0 ile 1 arasında rastgele bir sayıdır.

    İstemci başarılı bir HTTP yanıtı aldıktan sonra, istemcinin geri alma modundan çıkması ve yukarıda belirtilen minimum bekleme süresini uygulaması gerekir.