Evaluate API verwenden

Übersicht

Mit der Evaluate API können Ihre Client-Anwendungen die Schädlichkeit einer URL bewerten. Diese API unterscheidet sich von der Lookup API darin, dass sie einen Konfidenzwert in Bezug auf die Schädlichkeit einer URL anstelle eines binären Ergebnisses zurückgibt.

Hinweis

Wenden Sie sich an den Vertrieb oder Ihren Customer Engineer, um Zugriff auf diese Funktion zu erhalten.

URLs auswerten

Senden Sie zum Auswerten einer URL eine HTTP-POST-Anfrage an die Methode evaluateUri:

  • Die Evaluate API unterstützt eine URL pro Anfrage. Um mehrere URLs zu prüfen, müssen Sie für jede URL eine separate Anfrage senden.
  • Für diese API wird nur der threatType SOCIAL_ENGINEERING unterstützt.
  • Mit der Option allow_scan wird festgelegt, ob Web Risk die angegebene URL scannen darf.
  • Die URL muss gültig sein (siehe RFC 2396), muss jedoch nicht kanonisiert werden.
  • Die HTTP-POST-Antwort gibt eine Bewertung pro threatType zurück, die das Konfidenzniveau angibt, inwieweit die angegebene URL schädlich ist.

Beispiel: evaluateUri

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

{
  "uri": "http://www.google.com",
  "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"
    }
  ]
}