अनुरोध फ़्रीक्वेंसी

यह दस्तावेज़ इन तरीकों पर लागू होता है:

  • एपीआई अपडेट करें (v4): fullHashes.find
  • एपीआई अपडेट करें (v4): threatListUpdates.fetch
  • अपडेट के अनुरोध

    सर्वर को ज़्यादा लोड होने से बचाने और बेहतर सुरक्षा का फ़ायदा पाने के लिए, अपडेट एपीआई (v4) लागू होता है कोई क्लाइंट सुरक्षित ब्राउज़िंग सर्वर को कितनी बार अनुरोध भेज सकता है, इसके लिए समय अंतराल यूआरएल की जांच करें (fullHashes.find) या स्थानीय डेटाबेस को अपडेट करने के लिए (threatListUpdates.fetch).

    डेटा के लिए शुरुआती अनुरोध 0 से 1 मिनट के बीच के क्लाइंट चालू या बंद होता है. बाद के अनुरोध सिर्फ़ इसके बाद ही किए जा सकते हैं: इंतज़ार की कम से कम अवधि या बैक-ऑफ़ मोड की समयसीमा खत्म हो चुकी है देखा गया.

    कम से कम इंतज़ार अवधि

    दोनों fullHashes.find रिस्पॉन्स और threatListअपडेट.फ़ेच जवाब एक minimumWaitDuration फ़ील्ड होना चाहिए जिसका पालन क्लाइंट को करना चाहिए.

    अगर रिस्पॉन्स में minimumWaitDuration फ़ील्ड सेट नहीं है, तो क्लाइंट ये काम कर सकते हैं जितनी बार चाहें उतनी बार अपडेट करें और जितने चाहें उतने threatListUpdates या fullHashes अनुरोध भेजें जो वे चाहते हैं.

    अगर रिस्पॉन्स में minimumWaitDuration फ़ील्ड सेट है, तो क्लाइंट ये काम नहीं कर सकते वे इंतज़ार की अवधि से ज़्यादा बार अपडेट होते हैं. उदाहरण के लिए, अगर fullHashes जवाब कम से कम 1 घंटे तक इंतज़ार करना होगा. क्लाइंट को कोई भी fullHashes अनुरोध नहीं भेजना चाहिए वह घंटा बीत जाने तक, भले ही उपयोगकर्ता किसी ऐसे यूआरएल पर जा रहा हो जिसका हैश प्रीफ़िक्स स्थानीय डेटाबेस. (ध्यान दें कि क्लाइंट कम से कम इंतज़ार अवधि से कम बार अपडेट कर सकते हैं लेकिन यह सुरक्षा पर बुरा असर पड़ सकता है.)

    बैक-ऑफ़ मोड

    अपने-आप बैक-ऑफ़ की सुविधा, इन दोनों सेवाओं पर लागू होती है fullHashes.find रिस्पॉन्स और threatListअपडेट.फ़ेच जवाब.

    ऐसे क्लाइंट जिन्हें एचटीटीपी रिस्पॉन्स नहीं मिलता है. जैसे, एचटीटीपी स्टेटस कोड 200 OK) को बैक-ऑफ़ मोड में जाना होगा. बैक-ऑफ़ मोड में, क्लाइंट को तय किए गए समय तक इंतज़ार करना होगा अवधि सेट नहीं की जा सकती है, ताकि वे सर्वर को दूसरा अनुरोध जारी कर सकें.

    क्लाइंट को बैक-ऑफ़ समय का हिसाब लगाने के लिए, इस फ़ॉर्मूला का इस्तेमाल करना होगा:

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

    N, लगातार होने वाले उन अनुरोधों की संख्या दिखाता है जो पूरे नहीं हो सकते (पहले असफल अनुरोध के बाद N=1 से शुरू करके). RAND, 0 और 1 के बीच की कोई संख्या होती है जिसे हर असफल अपडेट के बाद चुनना पड़ता है.

    क्लाइंट को एचटीटीपी रिस्पॉन्स मिलने के बाद, क्लाइंट को बैक-ऑफ़ मोड से बाहर निकलना होगा और उसे फ़ॉलो करना होगा इंतज़ार की कम से कम अवधि ऊपर बताया गया है.