Utilizzo dell'API Lookup
Panoramica
L'API Lookup consente alle applicazioni client di verificare se un URL è incluso in uno qualsiasi degli elenchi Web Risk.
Controllo degli URL
Per verificare se un URL è presente in un elenco Web Risk, invia una richiesta HTTP GET
al metodo
uris.search
:
- L'API Lookup supporta un URL per richiesta. Per controllare più URL, devi inviare una richiesta separata per ogni URL.
Puoi specificare più tipi di minaccia 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 canonico.
Se utilizzi l'API REST, devi codificare i parametri
GET
, come l'URI.La risposta HTTP
GET
restituisce i tipi di minaccia 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 di queste 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.
Passaggi successivi
Scopri di più sull'utilizzo dell'API Update.