跳转到主要内容
GET
/
shield
/
samples
cURL
curl --request GET \
  --url https://api.brightdata.com/shield/samples \
  --header 'Authorization: Bearer <token>'
[
  {
    "timestamp": "2024-02-07T11:35:45.197Z",
    "ip": "13.229.30.41",
    "zone": "zone_name",
    "bw": 82345,
    "time": 62594
  }
]

授权

​
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？

查询参数

​
from
string

请求数据的开始时间范围。例如：from=2018-07-01T00:00:00

​
to
string

请求数据的结束时间范围。例如：to=2018-07-02T00:00:00

​
cn
string

请求来源国家。例如：cn=uk

​
peer_cn
string

对端 IP 的国家。例如：peer_cn=us

​
categories
string

仅返回特定分类。例如：categories=ads

​
host
string

仅返回特定域名。例如：host=example.com

响应

200 - application/json

OK