使用 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 application-default 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 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/submissions"" | Select-Object -Expand Content

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

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