使用 Submission API

使用 Submission API

本页介绍了如何使用 Submission API 将您认为不安全的网址提交至安全浏览进行分析。经确认符合安全浏览政策的所有网址都将添加到安全浏览服务中。

准备工作

如要获取此功能，请联系我们的销售团队或您的客户工程师。

提交网址

如要提交网址，请向 projects.submissions.create 方法发送 HTTP POST 请求。

API 请求

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：您的 Google Cloud 项目 ID

HTTP 方法和网址：

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

请求 JSON 正文： 

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

如需发送请求，请选择以下方式之一：

curl

将请求正文保存在名为 request.json 的文件中，然后执行以下命令： 

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

将请求正文保存在名为 request.json 的文件中，然后执行以下命令： 

$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

您应该收到类似以下内容的 JSON 响应：

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