Utilizzo dell'API Submission v2

Panoramica

L'API Submission ti consente di inviare gli URL che ritieni non sicuri alla Navigazione sicura per l'analisi e di verificare in modo asincrono i risultati di questi invii. Gli URL di cui è stata appurata la conformità ai criteri di Navigazione sicura verranno aggiunti al servizio Navigazione sicura.

Prima di iniziare

Contatta il team di vendita o il tuo Customer Engineer per ottenere l'accesso a questa funzionalità.

Inviare URL

Per inviare un URL, invia una richiesta POST HTTP al metodo projects.uris.submit.

  • L'API Submission supporta un URL per richiesta. Per controllare più URL, devi inviare una richiesta separata per ogni URL.
  • L'URL deve essere valido (vedi RFC 2396), ma non deve essere canonicalizzato.
  • La risposta POST HTTP restituisce un elemento long-running operation. Per maggiori informazioni su come recuperare il risultato dell'invio, consulta la pagina Long-running operations.

Esempio

Metodo HTTP e URL: 

POST https://webrisk.googleapis.com/v1/projects/project-id/uris:submit

Corpo JSON richiesta: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

Curling

Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente 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/v1/projects/project-id/uris:submit"

PowerShell

Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente 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/v1/projects/project-id/uris:submit" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-id/operations/operation-id",
}