Utilizzo dell'API Lookup
Panoramica
L'API Lookup consente alle applicazioni client di verificare se un URL è incluso in uno degli elenchi Web Risk.
Controllo degli URL in corso...
Per verificare se un URL è in un elenco Web Risk, invia una richiesta GET
HTTP al metodo uris.search
:
- L'API Lookup supporta un solo URL per richiesta. Per controllare più URL, devi inviare una richiesta separata per ogni URL.
Puoi specificare più tipi di minacce in una singola richiesta ripetendo il campo
threatTypes
. Ad esempio:&threatTypes=SOCIAL_ENGINEERING&threatTypes=MALWARE
L'URL deve essere valido (vedi RFC 2396), ma non deve essere canonicalizzato.
Se utilizzi l'API REST, devi codificare i parametri
GET
, come l'URI.La risposta HTTP
GET
restituisce i tipi di minacce corrispondenti, se presenti, insieme alla scadenza della cache.
Esempio: uris.search
Metodo HTTP e URL:
GET https://webrisk.googleapis.com/v1/uris:search?threatTypes=MALWARE&uri=http%3A%2F%2Ftestsafebrowsing.appspot.com%2Fs%2Fmalware.html&key=API_KEY
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
curl -X GET \
"https://webrisk.googleapis.com/v1/uris:search?threatTypes=MALWARE&uri=http%3A%2F%2Ftestsafebrowsing.appspot.com%2Fs%2Fmalware.html&key=API_KEY"
PowerShell
Esegui questo comando:
$headers = @{ }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://webrisk.googleapis.com/v1/uris:search?threatTypes=MALWARE&uri=http%3A%2F%2Ftestsafebrowsing.appspot.com%2Fs%2Fmalware.html&key=API_KEY" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "threat": { "threatTypes": [ "MALWARE" ], "expireTime": "2019-07-17T15:01:23.045123456Z" } }
Java
Python
Se nessun risultato corrisponde alla tua richiesta, riceverai una risposta JSON vuota di {}
.
Ciò significa che l'URL fornito non è presente in nessun elenco di minacce.
Durate della cache
Il campo expireTime
indica il timestamp in cui la corrispondenza deve essere considerata scaduta. Per maggiori dettagli, vedi Memorizzazione nella cache.
Che cosa succede dopo?
Scopri di più sull'utilizzo dell'API Update.