Method: urls.search

Cerca URL corrispondenti a minacce note. Vengono controllati ogni URL e le relative espressioni di suffisso host e prefisso percorso (fino a una profondità limitata). Ciò significa che la risposta potrebbe contenere URL non inclusi nella richiesta, ma che sono espressioni degli URL richiesti.

Richiesta HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/urls:search

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
urls[]

string

Obbligatorio. Gli URL da cercare. I client NON DEVONO inviare più di 50 URL.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La risposta restituita dopo la ricerca di minacce corrispondenti agli URL specificati.

Se non viene trovato nulla, il server restituirà uno stato OK (codice di stato HTTP 200) con il campo threats vuoto, anziché uno stato NOT_FOUND (codice di stato HTTP 404).

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Campi
threats[]

object (ThreatUrl)

Elenco non ordinato. L'elenco non ordinato delle corrispondenze di minacce trovate. Ogni voce contiene un URL e i tipi di minaccia trovati corrispondenti a quell'URL. Le dimensioni dell'elenco possono essere maggiori del numero di URL nella richiesta, in quanto sono state prese in considerazione tutte le espressioni dell'URL.
cacheDuration

string (Duration format)

La durata della cache lato client. Il client DEVE aggiungere questa durata all'ora corrente per determinare l'ora di scadenza. Il tempo di scadenza viene quindi applicato a ogni URL interrogato dal client nella richiesta, indipendentemente dal numero di URL restituiti nella risposta. Anche se il server non restituisce corrispondenze per un determinato URL, anche questo fatto DEVE essere memorizzato nella cache dal client.

Se e solo se il campo threats è vuoto, il client PUÒ aumentare il valore di cacheDuration per determinare una nuova scadenza successiva a quella specificata dal server. In ogni caso, la durata della cache aumentata non deve superare le 24 ore.

Importante: il client NON DEVE presupporre che il server restituirà la stessa durata della cache per tutte le risposte. Il server PUÒ scegliere durate della cache diverse per risposte diverse a seconda della situazione.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

ThreatUrl

Un URL corrispondente a una o più minacce.

Rappresentazione JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Campi
url

string

L'URL richiesto che è stato associato a una o più minacce.
threatTypes[]

enum (ThreatType)

Elenco non ordinato. L'elenco non ordinato delle minacce a cui è classificato l'URL.