Method: hashList.get

获取哈希列表的最新内容。哈希列表可能以威胁列表或非威胁列表(如 Global Cache)为依据。

这是 https://google.aip.dev/131 定义的标准 Get 方法,HTTP 方法也是 GET。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。此特定哈希列表的名称。它可能是威胁列表,也可能是全球缓存。

查询参数

参数
version

string (bytes format)

客户端已有的哈希列表版本。如果这是客户端首次提取哈希列表,则必须将此字段留空。否则,客户端应提供之前从服务器接收的版本。客户端不得操纵这些字节。

V5 的新变化:在 API 的 V4 版本中,它称为 states;为清楚起见,现在已重命名为 version

使用 base64 编码的字符串。

desiredHashLength

enum (HashLength)

所返回哈希的所需哈希前缀长度(以字节为单位)。然后,服务器会返回此指定长度的所有哈希前缀。

不同的哈希列表对 desiredHashLength 字段的可接受值有不同的要求。您可以在 HashListMetadatasupportedHashLengths 字段中找到此信息。如果 desiredHashLength 未在 supportedHashLengths 中指定值,则会返回错误。

sizeConstraints

object (SizeConstraints)

对列表的大小限制。如果省略,则不存在任何限制条件。建议为处理能力、带宽或存储空间有限的所有设备添加限制条件。

请求正文

请求正文必须为空。

响应正文

如果成功,则响应正文包含一个 HashList 实例。