Method: hashList.get

Recupera i contenuti più recenti di un elenco di hash. Un elenco di hash può essere un elenco di minacce o un elenco di non minacce, come la cache globale.

Si tratta di un metodo Get standard come definito da https://google.aip.dev/131 e il metodo HTTP è anche GET.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome di questo elenco di hash specifico. Potrebbe trattarsi di un elenco di minacce o della cache globale.

Parametri di query

Parametri
version

string (bytes format)

La versione dell'elenco di hash già in possesso del client. Se è la prima volta che il client recupera l'elenco di hash, questo campo DEVE essere lasciato vuoto. In caso contrario, il client DEVE fornire la versione precedentemente ricevuta dal server. Il client NON DEVE manipolare questi byte.

Novità della versione 5: nella versione 4 dell'API, questo parametro si chiamava states; ora è stato rinominato in version per maggiore chiarezza.

Una stringa con codifica Base64.
desiredHashLength
(deprecated)

enum (HashLength)

La lunghezza in byte del prefisso dell'hash desiderato degli hash restituiti. Il server restituirà quindi tutti i prefissi degli hash di questa lunghezza specificata.

Elenchi di hash diversi hanno requisiti diversi per i valori accettabili del campo desiredHashLength. Puoi trovarlo nel campo supportedHashLengths in HashListMetadata. Se desiredHashLength non specifica un valore all'interno di supportedHashLengths, viene restituito un errore.
sizeConstraints

object (SizeConstraints)

I vincoli di dimensioni dell'elenco. Se omesso, non ci sono vincoli. I vincoli sono consigliati su tutti i dispositivi con potenza di elaborazione, larghezza di banda o spazio di archiviazione limitati.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di HashList.