跳转到主要内容
POST
cURL
只有拥有 AdminOps 角色的用户才能执行此操作。
此 API 可能会修改你的账户设置、损害你的运营或产生费用。
将你的 API key 粘贴到授权字段中。要获取 API key,请创建账户,并了解如何生成新的 API key

ISP 代理区域示例

创建 ISP 区域需要特定的参数组合。以下字段不是可选的。省略它们会在不报错的情况下创建错误的区域类型或计费方案。
仅将 zone.type 设置为 ISP 会创建一个 Datacenter 区域,而不是 ISP 区域。你还必须将 plan.pool_ip_type 设置为 static_res。国家/地区代码必须为小写(例如 usgb)。大写代码会返回一个具有误导性的 “no IPs available” 错误。

共享 ISP(按 GB 计费)

共享 ISP(无限带宽)

仅设置 bandwidth: unlimited 不会激活无限计费。你还必须包含 unl_bw_tiers: std

专用 ISP(无限带宽)

Residential 代理区域

新的 Residential 区域需要通过 KYC 审核。 对于 2026 年 7 月 7 日之后创建的 Residential 区域,仅允许已通过 KYC 验证的公司添加区域。来自尚未完成 KYC 的账户的请求将被阻止,并返回 HTTP 403 及合规错误。2026 年 7 月 7 日(含)之前创建的 Residential 区域不受影响,可继续正常使用。请从 KYC 验证开始,并参阅 Residential 网络访问策略
在 2026 年 7 月 7 日之后创建任何 Residential 代理类型(共享轮换、IPv6 或专用)都需要 Bright Data 合规团队的 KYC 审核。对于这些新区域,没有自动或免 KYC 的途径。若未通过 KYC,请改为创建 ISPDatacenter 区域。

Residential 403 合规错误

对于 2026 年 7 月 7 日之后创建的 Residential 区域,来自不符合条件账户的添加区域请求将返回 HTTP 403 及以下合规错误之一。2026 年 7 月 7 日(含)之前创建的区域不受影响。完整目录请参阅代理错误目录 每个错误都会返回结构化的 JSON 响应体,便于集成程序根据稳定的 code 值进行分支处理。使用公司邮箱但未完成 KYC 的账户会收到 kyc_required
使用个人邮箱的账户会收到 business_account_required,该错误不提供 KYC,因为个人账户不具备资格:
两个响应体都包含一个 alternatives 数组,其中给出了用于改为创建免 KYC 的 ISPWeb Unlocker API 区域的确切 plan 对象。要创建该 ISP 区域,请在 POST /zone 请求中用该 plan 对象替换 Residential 的 plan

授权

Authorization
string
header
必填

在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。

认证方法:

  1. 从 Bright Data 账户设置获取您的 API Key: https://brightdata.com/cp/setting/users
  2. 在请求的 Authorization 头中包含 API Key
  3. 格式: Authorization: Bearer YOUR_API_KEY

示例:

了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?

请求体

application/json
zone
object
必填
示例:
plan
object
必填

响应

201

区域已添加