Method: fullHashes.find

Finds the full hashes that match the requested hash prefixes.

HTTP request

POST https://safebrowsing.googleapis.com/v4/fullHashes:find

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{
  "client": {
    object(ClientInfo)
  },
  "clientStates": [
    string
  ],
  "threatInfo": {
    object(ThreatInfo)
  },
  "apiClient": {
    object(ClientInfo)
  }
}
Fields
client

object(ClientInfo)

The client metadata.

clientStates[]

string (bytes format)

The current client states for each of the client's local threat lists.

A base64-encoded string.

threatInfo

object(ThreatInfo)

The lists and hashes to be checked.

apiClient

object(ClientInfo)

Client metadata associated with callers of higher-level APIs built on top of the client's implementation.

Response body

If successful, the response body contains data with the following structure:

JSON representation
{
  "matches": [
    {
      object(ThreatMatch)
    }
  ],
  "minimumWaitDuration": string,
  "negativeCacheDuration": string
}
Fields
matches[]

object(ThreatMatch)

The full hashes that matched the requested prefixes.

minimumWaitDuration

string (Duration format)

The minimum duration the client must wait before issuing any find hashes request. If this field is not set, clients can issue a request as soon as they want.

A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".

negativeCacheDuration

string (Duration format)

For requested entities that did not match the threat list, how long to cache the response.

A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".