Usar la API Submission

Usar la API Submission

En esta página se explica cómo usar la API Submission para enviar a Navegación segura URLs que sospechas que no son seguras para que las analice. Las URLs que se confirme que cumplen las políticas de Navegación segura se añaden al servicio Navegación segura.

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.

Enviar URLs

Para enviar una URL, envía una solicitud HTTP POST al método projects.submissions.create.

Solicitud de API

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

PROJECT_ID: tu ID de proyecto Google Cloud

Método HTTP y URL: 

POST https://webrisk.googleapis.com/v1/projects/PROJECT-ID/submissions

Cuerpo JSON de la solicitud: 

{
  "uri": "https://www.phishingsite.com/",
}

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 print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://webrisk.googleapis.com/v1/projects/PROJECT-ID/submissions"

PowerShell

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

$cred = gcloud auth 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/v1/projects/PROJECT-ID/submissions" | Select-Object -Expand Content

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

{
  "uri": "https://www.phishingsite.com/",
}