Method: hashList.get
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/03/06 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/03/06 (UTC)."],[[["Get the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method."],["The `name` path parameter specifies the hash list to retrieve."],["Provide the `version` query parameter to indicate the client's current hash list version or leave it empty for the initial fetch."],["Optionally, specify the desired hash prefix length using the `desiredHashLength` query parameter and set size constraints with the `sizeConstraints` parameter."],["The response body will contain the requested `HashList` data."]]],["This document details retrieving a hash list (threat or non-threat) using a `GET` request. The URL is structured as `https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`, with `name` being a required path parameter. Optional query parameters include `version` (client's current list version), `desiredHashLength` (hash prefix length), and `sizeConstraints` (list size limits). The request body is empty, and a successful response returns a `HashList` instance.\n"]]
