Method: hashList.get

Receber o conteúdo mais recente de uma lista de hash. Uma lista de hash pode ser gerada por uma lista de ameaças ou não relacionada a ameaças, como o cache global.

Esse é um método GET padrão, conforme definido por https://google.aip.dev/131 (link em inglês), e o método HTTP também é GET.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. É o nome dessa lista de hash específica. Pode ser uma lista de ameaças ou o cache global.

Parâmetros de consulta

Parâmetros
version

string (bytes format)

A versão da lista de hash que o cliente já tem. Se esta for a primeira vez que o cliente está buscando a lista de hash, esse campo PRECISA ser deixado em branco. Caso contrário, o cliente DEVE fornecer a versão recebida anteriormente do servidor. O cliente NÃO PODE manipular esses bytes.

Novidades na V5: na V4 da API, esse recurso era chamado de states. Agora, ele foi renomeado como version para maior clareza.

Uma string codificada em base64.
desiredHashLength

enum (HashLength)

O tamanho desejado do prefixo de hash dos hashes retornados em bytes. O servidor retornará todos os prefixos de hash nesse tamanho especificado.

Listas de hash diferentes têm requisitos distintos sobre os valores aceitáveis do campo desiredHashLength. Isso pode ser encontrado no campo supportedHashLengths em HashListMetadata. Se desiredHashLength não especificar um valor dentro de supportedHashLengths, será retornado um erro.
sizeConstraints

object (SizeConstraints)

As restrições de tamanho na lista. Se omitido, não há restrições. As restrições são recomendadas em todos os dispositivos com capacidade de processamento, largura de banda ou armazenamento limitados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de HashList.