> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 5 分钟快速入门：解锁您的第一个网站

> 学习如何在 5 分钟内使用 Bright Data 的 Web Unlocker API 解锁您的第一个网站。

本指南帮助您在 **5 分钟内使用 Bright Data Web Unlocker API 解锁第一个网站**。\
它专为想要快速验证其设置并查看真实结果，而无需深入高级配置的开发人员设计。

在本指南结束时，您将能够：

* 验证您的 Web Unlocker API 设置
* 发送实时解锁请求
* 从目标网站接收干净的 HTML 或 JSON 内容

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

确保您已经拥有：

* 一个 Bright Data 账户
* 一个活跃的 **Web Unlocker API 区域**
* 一个 [**API 密钥**](https://brightdata.com/cp/setting/users)

您可以在 [Bright Data 控制面板](https://brightdata.com/cp/web_access)中 Web Unlocker API 的 **Overview** 标签页中找到您的 **区域名称** 和 **API 密钥**。

如果您尚未创建 Web Unlocker API，请在继续前按照 **Create Your First Web Unlocker API** 进行操作。

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

选择一个公开 URL 来测��您的第一个解锁请求。

好的示例：

* [https://example.com](https://example.com)
* [https://httpbin.org/html](https://httpbin.org/html)

确保 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:

```json theme={null}
{
  "zone": "YOUR_ZONE_NAME",
  "url": "YOUR_TARGET_URL",
  "format": "raw"
}
```

此请求要求 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**