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)
用戶端發出任何搜尋雜湊要求前,必須等待的時間長度下限。如果不設定這個欄位,用戶端可隨時發出要求。 持續時間以秒為單位,最多 9 個小數位數,結尾為「s 」。範例:"3.5s" 。
|
negativeCacheDuration |
string (Duration format)
針對與威脅清單不相符的要求實體,快取回應的時間長度。 持續時間以秒為單位,最多 9 個小數位數,結尾為「s 」。範例:"3.5s" 。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-07 (世界標準時間)。
[null,null,["上次更新時間: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"]]