Utilizzo dell'API Lookup
Panoramica
L'API Lookup consente alle applicazioni client di verificare se un URL è incluso in qualsiasi degli elenchi Web Risk.
Controllo degli URL in corso...
Per verificare se un URL è in un elenco Web Risk, invia una richiesta GET
HTTP a
il uris.search
:
- L'API Lookup supporta un solo URL per richiesta. Per controllare più URL, è necessario di 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 è necessario che siano canonicalizzati.
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 a la 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 corrispondenza del quale deve trovarsi la corrispondenza.
considerata scaduta. Per maggiori dettagli, vedi Memorizzazione nella cache.
Passaggi successivi
Scopri di più sull'utilizzo dell'API Update.