Utiliser l'API Submission

Utiliser l'API Submission

Cette page explique comment utiliser l'API Submission pour envoyer des URL qui, selon vous, présentent un risque pour la navigation sécurisée à des fins d'analyse. Toutes les URL confirmées comme étant conformes aux règles de navigation sécurisée sont ajoutées au service de navigation sécurisée.

Avant de commencer

Contactez notre équipe commerciale ou votre ingénieur client pour accéder à cette fonctionnalité.

Envoi d'URL

Pour soumettre une URL, envoyez une requête HTTP POST à la méthode projects.submissions.create.

Requête API

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID de votre projet Google Cloud

Méthode HTTP et URL : 

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

Corps JSON de la requête : 

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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