Ce document s'applique aux méthodes suivantes :
Demandes de mises à jour
Pour éviter la surcharge du serveur et bénéficier d'une protection optimale, l'API Update (v4) impose périodes selon lesquelles un client peut envoyer des requêtes au serveur de navigation sécurisée effectuer des vérifications d'URL (fullHashes.find) ou pour mettre à jour la base de données locale (threatListUpdates.fetch).
La demande initiale de données doit être effectuée à un intervalle aléatoire compris entre 0 et une minute après la démarre ou se réveille. Les requêtes suivantes ne peuvent être envoyées qu'après l'événement Durée d'attente minimale la limite de temps du mode d'attente a été observée.
Durée d'attente minimale
Les
réponse fullHashes.find et
Réponse de ThreatListUpdates.fetch
comporte un champ minimumWaitDuration
que les clients doivent respecter.
Si le champ minimumWaitDuration
n'est pas défini dans la réponse, les clients peuvent
se mettent à jour aussi souvent qu'ils le souhaitent et envoient autant de requêtes threatListUpdates
ou fullHashes
que nécessaire.
qu'ils veulent.
Si le champ minimumWaitDuration
est défini dans la réponse, les clients ne peuvent pas
sont mises à jour plus fréquemment que le temps d'attente. Par exemple, si une réponse fullHashes
contient une durée d'attente minimale d'une heure, le client ne doit envoyer aucune requête fullHashes
avant que cette heure ne s'écoule, même si l'utilisateur accède à une URL dont le préfixe de hachage correspond au préfixe
base de données. (Notez que les clients peuvent effectuer des mises à jour moins souvent que la durée d'attente minimale, mais cette
peut avoir un impact négatif sur la protection.)
Mode d'attente
L'intervalle automatique entre les tentatives s'applique réponse fullHashes.find et réponse de ThreatListUpdates.fetch.
Les clients qui reçoivent une réponse HTTP d'échec (c'est-à-dire tout code d'état HTTP autre que
200 OK
) doit passer en mode intervalle entre les tentatives. Une fois en mode intervalle entre les tentatives, les clients doivent attendre l'heure calculée
de temps avant de pouvoir envoyer
une autre requête au serveur.
Les clients doivent utiliser la formule suivante pour calculer la durée de l'intervalle entre les tentatives:
MIN((2N-1 * 15 minutes) * (RAND + 1), 24 hours)
N correspond au nombre de requêtes consécutives ayant échoué que le client reçoit. (commençant par N=1 après la première requête ayant échoué). RAND est un nombre aléatoire compris entre 0 et 1. qui doit être choisi après chaque mise à jour ayant échoué.
Une fois qu'un client reçoit une réponse HTTP positive, il doit quitter le mode d'attente et suivre la durée d'attente minimale comme indiqué ci-dessus.