Method: hashList.get

获取哈希列表的最新内容。哈希列表可以是威胁列表,也可以是全球缓存等非威胁列表。

这是 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
(deprecated)

enum (HashLength)

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

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

sizeConstraints

object (SizeConstraints)

列表的大小限制。如果省略,则表示无限制。建议在处理能力、带宽或存储空间有限的所有设备上使用限制。

请求正文

请求正文必须为空。

响应正文

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