Evaluate API verwenden

Auf dieser Seite wird erläutert, wie Sie mithilfe der Evaluate API die Client-Anwendungen auf die Schädlichkeit einer URL prüfen können. Diese API gibt einen Konfidenzwert zurück, der auf die Schädlichkeit einer URL hinweist. Wenn Sie statt eines Konfidenzwerts ein binäres Ergebnis erhalten möchten, verwenden Sie die Lookup API.

Hinweis

Wenden Sie sich an unser Vertriebsteam oder Ihren Kundenentwickler, um Zugriff auf diese Funktion zu erhalten.

URLs auswerten

Senden Sie zum Auswerten einer URL eine HTTP-POST-Anfrage an die Methode evaluateUri. Beachten Sie beim Bewerten von URLs die folgenden Überlegungen:

  • Die Evaluate API unterstützt eine URL pro Anfrage. Wenn Sie mehrere URLs prüfen möchten, senden Sie für jede URL eine separate Anfrage.
  • Die URL muss gültig sein und muss nicht kanonisiert werden. Weitere Informationen finden Sie unter RFC 2396.
  • Für diese API wird nur der threatType SOCIAL_ENGINEERING unterstützt.
  • Die Option allow_scan legt fest, ob Web Risk die angegebene URL scannen darf.
  • Die HTTP-Antwort POST gibt einen Konfidenzwert für den angegebenen Bedrohungstyp zurück. Der Konfidenzwert gibt den Konfidenzgrad an, der angibt, wie risikoreich die angegebene URL ist.

API-Anfrage

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

URL: eine URL, die ausgewertet werden muss

HTTP-Methode und URL:

POST "https://webrisk.googleapis.com/v1eap1:evaluateUri"

JSON-Text der Anfrage:

{
  "uri": "URL",
  "threatTypes": "SOCIAL_ENGINEERING",
  "allowScan": "true"
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
""https://webrisk.googleapis.com/v1eap1:evaluateUri""

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri ""https://webrisk.googleapis.com/v1eap1:evaluateUri"" | Select-Object -Expand Content

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

{
  "scores": [
    {
      "threatType": "SOCIAL_ENGINEERING",
      "confidenceLevel": "SAFE"
    }
  ]
}