Lookup API verwenden

Überblick

Mit der Lookup API können Ihre Client-Anwendungen prüfen, ob eine URL in einer der Web Risk-Listen enthalten ist.

URLs prüfen

Senden Sie eine HTTP-GET-Anfrage an die Methode uris.search, um zu prüfen, ob sich eine URL auf einer Liste mit Webrisiken befindet:

• Die Lookup API unterstützt eine URL pro Anfrage. Um mehrere URLs zu prüfen, müssen Sie für jede URL eine separate Anfrage senden.

• Sie können mehrere Bedrohungsarten in einer einzelnen Anfrage angeben, indem Sie das Feld threatTypes wiederholen. Beispiel:

  &threatTypes=SOCIAL_ENGINEERING&threatTypes=MALWARE
  

• Die URL muss gültig sein (siehe RFC 2396), muss jedoch nicht kanonisiert werden.

• Wenn Sie die REST API verwenden, müssen Sie GET-Parameter wie den URI codieren.

• Die HTTP-GET-Antwort gibt die entsprechenden Bedrohungsarten (falls vorhanden) sowie den Cache-Ablauf zurück.

Beispiel: uris.search

HTTP-Methode und URL:

GET https://webrisk.googleapis.com/v1/uris:search?threatTypes=MALWARE&uri=http%3A%2F%2Ftestsafebrowsing.appspot.com%2Fs%2Fmalware.html&key=API_KEY

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

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"

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "threat": {
    "threatTypes": [
      "MALWARE"
    ],
    "expireTime": "2019-07-17T15:01:23.045123456Z"
  }
}

import com.google.cloud.webrisk.v1.WebRiskServiceClient;
import com.google.webrisk.v1.SearchUrisRequest;
import com.google.webrisk.v1.SearchUrisResponse