使用 Lookup API
總覽
Lookup API 可讓您的用戶端應用程式檢查網址是否列在任何 Web Risk 清單中。
檢查網址
如要檢查網址是否列於 Web Risk 清單中,請將 HTTP GET
要求傳送至 uris.search
方法:
- Lookup API 支援每個要求一個網址。如要檢查多個網址,請為每個網址分別提出要求。
您可以在單一要求中指定多個威脅類型,方法是重複
threatTypes
欄位。例如:&threatTypes=SOCIAL_ENGINEERING&threatTypes=MALWARE
網址必須有效 (請參閱 RFC 2396),但不需要正規化。
如果您使用 REST API,就必須編碼
GET
參數,例如 URI。HTTP
GET
回應會傳回相符的威脅類型 (如有),以及快取到期時間。
範例:uris.search
HTTP 方法和網址:
GET https://webrisk.googleapis.com/v1/uris:search?threatTypes=MALWARE&uri=http%3A%2F%2Ftestsafebrowsing.appspot.com%2Fs%2Fmalware.html&key=API_KEY
如要傳送要求,請選擇以下其中一個選項:
curl
執行下列指令:
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
執行下列指令:
$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
您應該會收到如下的 JSON 回應:
{ "threat": { "threatTypes": [ "MALWARE" ], "expireTime": "2019-07-17T15:01:23.045123456Z" } }
Java
Python
如果沒有任何結果符合要求,您會收到空白的 JSON 回應 {}
。
這表示你提供的網址不在任何威脅清單中。
快取時間長度
expireTime
欄位表示比對應視為過期的時間戳記。詳情請參閱「快取」。
後續步驟
瞭解如何使用 Update API。