Method: hashList.get

Obtenez le dernier contenu d'une liste de hachage. Une liste de hachage peut être une liste de menaces ou une liste de non-menaces, comme le cache global.

Il s'agit d'une méthode GET standard telle que définie par https://google.aip.dev/131. La méthode HTTP est également GET.

Requête HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de cette liste de hachage spécifique. Il peut s'agir d'une liste de menaces ou du cache global.

Paramètres de requête

Paramètres
version

string (bytes format)

Version de la liste de hachage dont le client dispose déjà. Si le client récupère la liste de hachage pour la première fois, ce champ DOIT être laissé vide. Dans le cas contraire, le client DOIT fournir la version précédemment reçue du serveur. Le client NE DOIT PAS manipuler ces octets.

Nouveautés de la version 5: dans la version 4 de l'API, cette valeur était appelée states. Elle est désormais rebaptisée version pour plus de clarté.

Chaîne encodée en base64.
desiredHashLength
(deprecated)

enum (HashLength)

Longueur du préfixe de hachage souhaité des hachages renvoyés en octets. Le serveur renvoie ensuite tous les préfixes de hachage de cette longueur spécifiée.

Les différentes listes de hachage ont des exigences différentes concernant les valeurs acceptables du champ desiredHashLength. Vous le trouverez dans le champ supportedHashLengths de HashListMetadata. Si desiredHashLength ne spécifie pas de valeur dans supportedHashLengths, une erreur est renvoyée.
sizeConstraints

object (SizeConstraints)

Contraintes de taille de la liste. Si elle est omise, aucune contrainte ne s'applique. Nous vous recommandons d'appliquer des contraintes sur tous les appareils dont la puissance de traitement, la bande passante ou l'espace de stockage sont limités.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de HashList.