Usar a API Submission

Usar a API Submission

Esta página explica como usar a API Submission para enviar URLs que suspeita serem inseguros para análise pela Navegação Segura. Todos os URLs que se confirme corresponderem às políticas da Navegação segura são adicionados ao serviço de Navegação segura.

Antes de começar

Contacte a nossa equipa de vendas ou o seu engenheiro de apoio técnico para obter acesso a esta funcionalidade.

Enviar URLs

Para enviar um URL, envie um pedido HTTP POST para o método projects.submissions.create.

Pedido de API

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

PROJECT_ID: o ID do seu Google Cloud projeto

Método HTTP e URL: 

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

Corpo JSON do pedido: 

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

Para enviar o seu pedido, escolha uma destas opções:

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Deve receber uma resposta JSON semelhante à seguinte:

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