跳转到主要内容
POST
/
zone
/
ips
cURL
curl --request POST \
  --url https://api.brightdata.com/zone/ips \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer": "<string>",
  "zone": "<string>",
  "count": 123,
  "country": "us",
  "country_city": "us-chicago"
}
'
{
  "ips": [
    "1.1.1.1",
    "1.1.1.2",
    "1.1.1.3"
  ],
  "new_ips": [
    "1.1.1.1",
    "1.1.1.3"
  ]
}
警告: 此 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
customer
string
必填

客户名称

zone
string
必填

区域名称

count
number
必填

IP 数量

country
string

新 IP 的国家,例如 us

示例:

"us"

country_city
string

新 IP 的城市,例如 us-chicago

示例:

"us-chicago"

响应

200 - application/json

成功

ips
string[]
示例:
["1.1.1.1", "1.1.1.2", "1.1.1.3"]
new_ips
string[]
示例:
["1.1.1.1", "1.1.1.3"]