Method: fullHashes.find
HTTP 请求
POST https://safebrowsing.googleapis.com/v4/fullHashes:find
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"client": {
object (ClientInfo )
},
"clientStates": [
string
],
"threatInfo": {
object (ThreatInfo )
},
"apiClient": {
object (ClientInfo )
}
} |
字段 |
client |
object (ClientInfo )
客户端元数据。
|
clientStates[] |
string (bytes format)
每个客户端本地威胁列表的当前客户端状态。 使用 base64 编码的字符串。
|
threatInfo |
object (ThreatInfo )
要检查的列表和哈希。
|
apiClient |
object (ClientInfo )
与基于客户端实现构建的更高级 API 的调用方相关联的客户端元数据。
|
响应正文
JSON 表示法 |
{
"matches": [
{
object (ThreatMatch )
}
],
"minimumWaitDuration": string,
"negativeCacheDuration": string
} |
字段 |
matches[] |
object (ThreatMatch )
与所请求前缀匹配的完整哈希。
|
minimumWaitDuration |
string (Duration format)
在发出任何查找哈希请求之前,客户端必须等待的最短时长。如果未设置此字段,客户端可以尽快发出请求。 该时长以秒为单位,最多包含九个小数位,以“s ”结尾。示例:"3.5s" 。
|
negativeCacheDuration |
string (Duration format)
对于与威胁列表不匹配的请求实体,缓存响应的时间长度。 该时长以秒为单位,最多包含九个小数位,以“s ”结尾。示例:"3.5s" 。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-07。
[null,null,["最后更新时间 (UTC):2024-09-07。"],[[["This API finds full hashes that match requested hash prefixes using a POST request to `https://safebrowsing.googleapis.com/v4/fullHashes:find`."],["The request body includes client metadata, client states, threat information, and API client details, structured according to the provided JSON schema."],["The response body provides matching full hashes, minimum wait duration before the next request, and negative cache duration for non-matching entities, all formatted as described in the schema."]]],["This document details the process for finding full hashes matching requested hash prefixes via the `fullHashes:find` API. A `POST` request to the specified URL includes a JSON request body with client metadata (`client`, `apiClient`), client states (`clientStates`), and threat information (`threatInfo`). The response, if successful, contains matched full hashes (`matches`), a minimum wait duration (`minimumWaitDuration`) before the next request, and a negative cache duration (`negativeCacheDuration`).\n"]]