跳转到主要内容
POST
/
zone
/
whitelist
cURL
curl --request POST \
  --url https://api.brightdata.com/zone/whitelist \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ip": "<string>",
  "zone": "<string>"
}
'
警告： 此 API 可能会修改您的账户设置、影响您的业务操作或产生费用。
将您的 API key 粘贴到授权字段中。要获取 API key，请创建账号，并查看如何生成新的 API key？

授权

​
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

示例:

Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df

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

请求体

application/json
​
ip
必填

string 或 array of strings

单个 IP、IP 数组、IP 范围、IP 子网或 IP 掩码

示例

  • 单个 IP: 10.20.30.40

  • IP 数组: ["10.20.30.40", "50.60.70.80",...]

  • 范围: 10.20.30.40-10.20.30.50

  • 子网: 10.20.30.0/24

  • 子网掩码: 10.20.30.0/255.255.252.0

注意 IP 数组语法要求数组中每个 IP 字符串使用引号 "

​
zone
string

区域名称，可省略以影响所有区域

响应

201

成功