Deliver a snapshot to Amazon S3, Azure Blob Storage or a Webhook
Archive API
将快照传送到 S3、Azure Blob 或 GCP
将 Bright Data Archive API 快照传送到 Amazon S3、Azure Blob Storage、Google Cloud Storage 或 webhook。POST /webarchive/dump 返回 dump_id。
POST
Deliver a snapshot to Amazon S3, Azure Blob Storage or a Webhook
POST /webarchive/dump 将已完成搜索的快照传送到 Amazon S3、Azure Blob Storage、Google Cloud Storage 或 webhook,并返回 dump_id。
要使用 Google Cloud Storage 传递,请创建一个存储桶并提供所需的 GCP 传递设置。
常见数据转储参数:
search_id(必需):来自已完成搜索的搜索 IDmax_entries(可选):限制要包含在数据转储中的文件数量delivery(必需):传递配置(S3、Azure、GCP 或 webhook)
什么情况会返回 400
当请求体未通过校验时,POST /webarchive/dump 返回 HTTP 400。响应包含 error 摘要和列出每个校验失败字段的 details 数组。常见原因:
- 缺少
search_id。 - 缺少
delivery。 delivery.settings与所选的delivery.strategy不匹配。每种策略有各自的必需设置:Amazon S3 需要bucket和assume_role,Google Cloud Storage 需要bucket,Azure Blob Storage 需要container和credentials,webhook 需要url。
details[].path 中指出的字段后重新发送请求。授权
Use your Bright Data API Key as a Bearer token in the Authorization header.
How to authenticate:
- Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
- Include the API Key in the Authorization header of your requests
- Format:
Authorization: Bearer YOUR_API_KEY
Example:
Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication
请求体
application/json
响应
Dump created successfully
ID of the created dump
示例:
"ucd_abc123-1234567890"