ينطبق هذا المستند على الطرق التالية:
طلبات التحديث
لمنع الحمل الزائد على الخادم والاستفادة من الحماية المثلى، تفرض واجهة برمجة التطبيقات Update API (الإصدار 4) فواصل زمنية لعدد المرات التي يمكن للعميل فيها إرسال طلبات إلى خادم التصفح الآمن إلى إجراء عمليات التحقّق من عناوين URL (fullHashes.find) أو لتحديث قاعدة البيانات المحلية (threatListUpdates.fetch).
يجب أن يحدث الطلب الأولي للبيانات على فترات عشوائية تتراوح بين 0 ودقيقة بعد العميل أو يستيقظ. لا يمكن أن تحدث الطلبات اللاحقة إلا بعد الحد الأدنى لمدة الانتظار أو تم بلوغ الحد الزمني الخاص بوضع التراجع ملاحظتها.
الحد الأدنى لمدة الانتظار
يتم تحديث
استجابة fullHashes.find و
ردّ threatListUpdates.fetch
أن يتضمّن حقل minimumWaitDuration يجب على العملاء الالتزام به.
إذا لم يتم ضبط الحقل minimumWaitDuration في الردّ، يمكن للعملاء
يتم التعديل بالقدر الذي يريده وإرسال أكبر عدد ممكن من طلبات threatListUpdates أو fullHashes
التي يريدونها.
إذا تم ضبط الحقل minimumWaitDuration في الردّ، لن تتمكّن العملاء
يتم تحديثه بشكل متكرر أكثر من طول مدة الانتظار. على سبيل المثال، إذا كانت الاستجابة fullHashes
يحتوي على حد أدنى لمدة الانتظار يبلغ ساعة واحدة، ويجب ألا يرسل العميل أي طلبات باللغة fullHashes
حتى مرور هذه الساعة، حتى إذا انتقل المستخدم إلى عنوان URL تتطابق بادئة تجزئةه مع العنوان المحلي
قاعدة البيانات. (لاحظ أنه يمكن للعملاء التحديث بشكل أقل من الحد الأدنى لمدة الانتظار ولكن هذا
قد تؤثر سلبًا على الحماية).
وضع التراجع
وينطبق التراجع التلقائي على كل من استجابة fullHashes.find و رد threatListUpdates.fetch
العملاء الذين يتلقون استجابة HTTP غير ناجحة (أي أي رمز حالة HTTP بخلاف
200 OK) في وضع التراجع. بمجرد دخول وضع التراجع، يجب على العملاء انتظار الوقت المحسوب
المدة قبل إصدار طلب آخر إلى الخادم.
يجب على العملاء استخدام الصيغة التالية لحساب مدة فترة التراجع:
MIN((2N-1 * 15 minutes) * (RAND + 1), 24 hours)يتوافق N مع عدد الطلبات المتتالية غير الناجحة التي يجربها العميل (يبدأ بـ N=1 بعد أول طلب غير ناجح). RAND هو رقم عشوائي بين 0 و1. يجب اختياره بعد كل تحديث غير ناجح.
بمجرد أن يتلقى العميل استجابة HTTP ناجحة، يجب على العميل الخروج من وضع التراجع والمتابعة الحدّ الأدنى لمدة الانتظار المحددة أعلاه.