Usar la API de evaluación

En la página, se explica cómo usar la API de Evaluar para permitir que las aplicaciones cliente evalúen la maliciosa de una URL. Esta API muestra una puntuación de confianza que indica si una URL es maliciosa. Si deseas obtener un resultado binario en lugar de una puntuación de confianza, usa la API de Lookup.

Antes de comenzar

Comunícate con nuestro equipo de ventas o con el ingeniero de clientes para obtener acceso a esta característica.

Evalúa URL

Para evaluar una URL, envía una solicitud POST HTTP al método evaluateUri. Ten en cuenta las siguientes consideraciones cuando evalúes las URL:

  • La API de evaluación admite una URL por solicitud. Si quieres verificar varias URL, envía una solicitud individual para cada una.
  • La URL debe ser válida y no debe estar canónica. Para obtener más información, consulta RFC 2396.
  • Solo se admite el tipo de amenaza SOCIAL_ENGINEERING para esta API.
  • La opción allow_scan determina si el riesgo web puede analizar la URL proporcionada.
  • La respuesta HTTP POST muestra una puntuación de confianza para el tipo de amenaza especificado. La puntuación de confianza representa el nivel de confianza que indica el riesgo de la URL especificada.

Solicitud a la API

Antes de usar cualquiera de los datos de solicitud, realiza los siguientes reemplazos:

URL: Es una URL que se debe evaluar.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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