Skip to main content
本指南帮助您在 5 分钟内使用 Bright Data Web Unlocker API 解锁第一个网站。
它专为想要快速验证其设置并查看真实结果，而无需深入高级配置的开发人员设计。 在本指南结束时，您将能够：
  • 验证您的 Web Unlocker API 设置
  • 发送实时解锁请求
  • 从目标网站接收干净的 HTML 或 JSON 内容

​
开始前需要准备的内容（1 分钟）

确保您已经拥有：
  • 一个 Bright Data 账户
  • 一个活跃的 Web Unlocker API 区域
  • 一个 API 密钥
您可以在 Bright Data 控制面板中 Web Unlocker API 的 Overview 标签页中找到您的 区域名称 和 API 密钥。 如果您尚未创建 Web Unlocker API，请在继续前按照 Create Your First Web Unlocker API 进行操作。

​
第 1 步：选择一个测试网站（30 秒）

选择一个公开 URL 来测��您的第一个解锁请求。 好的示例： 确保 URL：
  • 可公开访问
  • 以 https:// 或 http:// 开头

​
第 2 步：了解您即将发送的内容（30 秒）

Web Unlocker API 通过 单一 REST 端点 工作。 您将发送：
  • 您的 API 密钥（用于身份验证）
  • 您的 Web Unlocker API 区域名称
  • 您想要解锁的目标 URL
Bright Data 将自动：
  • 选择最佳代理网络
  • 处理反机器人保护
  • 如果需要，重试失败的尝试

​
第 3 步：发送您的第一个解锁请求（2 分钟）

将下面的占位符替换为您的实际值：
  • YOUR_API_KEY
  • YOUR_ZONE_NAME
  • YOUR_TARGET_URL
示例请求： POST https://api.brightdata.com/request Headers:
  • Authorization: Bearer YOUR_API_KEY
  • Content-Type: application/json
Body:
此请求要求 Web Unlocker API 获取目标页面，并以原始 HTML 形式返回解锁的响应。

​
第 4 步：查看响应（30 秒）

如果请求成功，您将收到：
  • HTTP 状态：200 OK
  • 包含解锁内容的响应体
  • HTML 或 JSON，取决于您请求的格式
如果您能看到页面内容，说明您的 Web Unlocker API 工作正常��

​
常见问题和快速修复（30 秒）

  • 401 Unauthorized
    身份验证缺失或无效
    → 验证 Authorization 标头和 API 密钥
  • 400 Bad Request
    请求负载无效
    → 确保 zone、url 和 format 存在
  • 内容看起来不完整
    → 尝试另一个公开 URL 或查看配置选项

​
您刚才完成的工作

在 5 分钟内，您：
  • 使用 Web Unlocker API 进行了身份验证
  • 发送了真实的解锁请求
  • 从网站检索了干净、可用的内容
这确认您的设置正确，并准备好处理真实工作负载。

​
后续步骤

一旦您的第一个请求成功，您可以：
  • 启用 地理位置 功能以获取特定地区的内容
  • 使用 异步请求 处理大批量
  • 配置 高级域名 以处理更难的目标
  • 浏览 Send Your First Request 了解高级示例
  • 如果遇到错误，查看 Troubleshooting