Skip to main content

几分钟内发送您的第一个请求

使用以下现成的代码示例,您可以在几分钟内测试 Web Unlocker API。

Node.js 示例

Python 示例

Bright Data 提供两种访问 Web Unlocker API 的方式,两者输出结果完全相同,但可满足不同工作流程需求:

直接 API 访问(推荐)

一种纯 REST API 的访问方式,简单易用,便于集成。

原生代理访问

适用于依赖代理路由的工作流程。

直接 API 访问(推荐)

一种简单且符合 REST 规范的方式,可与 Bright Data 的 Web Unlocker API 交互。此方式抽象了代理管理,让您通过统一的端点发送请求,使集成更加轻松直接。

适用于:

  • 集中化端点:通过单一 REST 端点访问 Web Unlocker API。
  • 简化的直接集成:无需处理代理或路由的复杂性。
  • 单个 API key 身份认证:安全且易于使用,无需管理用户名密码。

发送您的第一个请求

在完成 Web Unlocker API 区域的设置后,您可以在该区域的 Overview 选项卡中找到可用的 Web Unlocker API 请求示例以及您的 API key:
Web Unlocker API Overview tab
以下为一个简单的 Web Unlocker API cURL 请求示例:
Direct API access - cURL

请求解析

  1. API 端点:https://api.brightdata.com/request
  2. 身份认证 Header:Authorization: Bearer [INSERT YOUR API key]
    • 您的 API key 可在 Web Unlocker API 区域中找到。
  3. Payload:
    • zone:您的 Web Unlocker API 区域名称
    • url:您想通过 Web Unlocker API 访问的目标 URL。
    • format:响应格式。使用 raw 可获取目标站点的原始响应。
    • 【可选】body:指定发送到目标 URL 的 POST 原始数据。例如 "body": "{\"key\":\"value\"}"

生成您的 Bright Data API key

Bright Data API key 是您访问 Web Unlocker API(通过直接 API 访问)时使用的安全身份认证凭据。在控制面板中新建 Web Unlocker API 区域时,系统会自动生成一个 API key,并显示在该区域的 Overview 中。
Web Unlocker API key
生成新 API key 的步骤:
  • 访问 Account settings
  • 向下滚动并点击 Add API key。
  • 按照屏幕提示完成流程。
强烈建议您为 API key 设置过期日期,以提高安全性。
API key 仅会在首次生成时显示一次,请务必根据您组织的安全策略妥善保存。

原生代理访问

要使用原生代理方式访问 Web Unlocker,您需要以下凭证:
  1. 您的 Customer ID(客户 ID)
  2. 您的 Web Unlocker API 区域名称
  3. 您的 Web Unlocker API 密码
  4. Bright Data SSL 证书

Customer ID

您可以在欢迎邮件中找到 Customer ID,也可以点击控制面板右上角的账户首字母,或打开此页面查看: Account settings

区域名称与密码

区域名称和密码可在控制面板中 Web Unlocker 区域的 Overview 页面中找到。

Bright Data SSL 证书

为避免 SSL 错误,请务必设置 Bright Data SSL 证书
您可以通过区域 Overview 顶部菜单中的 “SSL certificate” 向导获取证书。更多说明请参见: SSL certificate 或者,您也可以忽略 SSL 错误

Web Unlocker API:HTTPS Proxy 代码示例

准备好凭证之后,您可以使用以下代码发送首个请求:
上述代码示例使用住宅代理向 http://brdtest.com/myip.json 发送请求。 它将以 JSON 格式返回你的 IP 信息:
Output
现在,将 “https://brdtest.com/myip.json” 替换为你选择的网站即可。
如需交互式查看 Web Unlocker API 的全部用例、集成方式和配置选项,请访问控制面板中的 API 示例页面。

常见问题和快速修复

  • 401 Unauthorized 身份验证缺失或无效。 → 请检查 Authorization 标头和 API 密钥。
  • 400 Bad Request 请求负载无效。 → 请确保 zoneurlformat 均已提供。
  • 内容看起来不完整 → 尝试另一个公开 URL,或查看配置选项
完整的状态码及其原因见错误码

发送您的第一个异步请求

异步请求会提交任务并立即返回 response_id,稍后再收取结果。当您不需要在同一次 HTTP 响应中拿到解锁后的页面时,请使用异步方式。

启用异步请求

在您的 Web Unlocker API zone 中打开 Advanced settings,启用 Asynchronous requests
启用异步请求

提交任务

异步请求端点发送 POST 请求:
您应会收到一个 response_id

轮询获取结果

任务运行期间,API 返回 HTTP 202"Request is pending"。请按下表间隔轮询,否则 Bright Data 可能对无结果的频繁轮询进行限流: 任务完成后,收取结果
results.json 中包含状态码、响应标头以及解锁后的页面内容:

Bright Data 能把结果推送到我指定的地址吗?

可以。您无需轮询,只需配置 webhook,任务完成后 Bright Data 会将结果投递到您指定的 URL。详见 Webhooks 配置