Usar la API Evaluate

En esta página se explica cómo usar la API Evaluate para que tus aplicaciones cliente evalúen la peligrosidad de una URL. Esta API devuelve una puntuación de fiabilidad que indica la peligrosidad de una URL en función de las listas de bloqueo, los modelos de aprendizaje automático y las reglas heurísticas. Si quieres obtener un resultado binario en lugar de una puntuación de confianza, usa la API Lookup.

Nota: Las URLs enviadas a la API Evaluate pueden someterse a un procesamiento adicional, incluido el rastreo.

Antes de empezar

Ponte en contacto con nuestro equipo de Ventas o con tu ingeniero de atención al cliente para obtener acceso a esta función.

Evaluar URLs

Para evaluar una URL, envía una solicitud HTTP POST al método evaluateUri. Tenga en cuenta lo siguiente al evaluar URLs:

  • La API Evaluate admite una URL por solicitud. Si quiere comprobar varias URLs, envíe una solicitud para cada una de ellas.
  • La URL debe ser válida y no es necesario que sea canónica. Para obtener más información, consulta RFC 2396.
  • La API Evaluate admite tres threatTypes: SOCIAL_ENGINEERING, MALWARE y UNWANTED_SOFTWARE.
  • Obsoleto. El campo allow_scan se usaba para determinar si Web Risk tenía permiso para analizar la URL proporcionada. Esta función ya no se puede inhabilitar en la API Evaluate. Consulta las APIs Lookup y Update para ver opciones sin rastreo.
  • La respuesta HTTP POST devuelve una puntuación de fiabilidad 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 de API

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

URL: una URL que debe evaluarse.

Método HTTP y URL: 

POST https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY

Cuerpo JSON de la solicitud: 

{
  "uri": "URL",
  "threatTypes": ["SOCIAL_ENGINEERING", "MALWARE", "UNWANTED_SOFTWARE"]
}

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 "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY"

PowerShell

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

$headers = @{  }

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

Deberías recibir una respuesta JSON similar a la siguiente:

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