Method: hashList.get

Obtener el contenido más reciente de una lista de hash Una lista de hash puede ser mediante una lista de amenazas o una lista no relacionada con amenazas, como la Caché global.

Este es un método Get estándar, como se define en https://google.aip.dev/131, y el método HTTP también es GET.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. Es el nombre de esta lista de hash en particular. Puede ser una lista de amenazas o la caché global.

Parámetros de consulta

Parámetros
version

string (bytes format)

La versión de la lista de hash que ya tiene el cliente. Si es la primera vez que el cliente recupera la lista de hash, este campo DEBE dejarse vacío. De lo contrario, el cliente DEBE proporcionar la versión previamente recibida del servidor. El cliente NO DEBE manipular esos bytes.

Novedades de V5: En la versión 4 de la API, se llamaba states; ahora, se cambió su nombre por version para mayor claridad.

String codificada en base64.

desiredHashLength

enum (HashLength)

La longitud deseada del prefijo de hash de los hashes que se muestran, expresada en bytes. Luego, el servidor mostrará todos los prefijos de hash de esta longitud especificada.

Las diferentes listas de hash tienen diferentes requisitos en los valores aceptables del campo desiredHashLength. Puedes encontrarlo en el campo supportedHashLengths de HashListMetadata. Si desiredHashLength no especifica un valor en supportedHashLengths, se mostrará un error.

sizeConstraints

object (SizeConstraints)

Las restricciones de tamaño de la lista. Si se omite, no hay restricciones. Se recomiendan las restricciones en todos los dispositivos con capacidad de procesamiento, ancho de banda o almacenamiento limitados.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de HashList.