Skip to main content
POST
每个爬虫只需调用该端点一次。它返回已保存设置的 ID,例如 ash_lz3k9qw1,而不是设置内容本身。
自动自我修复的设置只能创建一次,无法通过 AI Flow API 修改。对同一个爬虫再次调用会返回 HTTP 409,并且没有用于读取、更新、删除或关闭这些设置的端点。请在 Bright Data Scraper Studio 的 Auto Self-Healing 标签页中修改或关闭自动自我修复。参见 Scraper Studio 自动自我修复。
请求能否被接受,取决于以下四条规则:
  • 每个请求都必须发送 collector、enabled、sr_threshold 和 trigger_frequency。当 trigger_frequency 为 per_job 时,还需发送 min_inputs_threshold。
  • 只能发送整数,小数会被拒绝。
  • 爬虫必须处于活跃状态。非活跃的爬虫会返回 HTTP 400 和 Collector must be active。
  • notification_emails 中的每个地址都必须属于该爬虫所在账户下的用户。
当 auto_save 为 false 时,请设置 notification_emails。此时修复作业会运行但不会保存代码,通知邮件是相关人员看到建议修复方案的唯一途径。

授权

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
collector
string
必填

要配置的 Scraper Studio 爬虫 ID,格式为 c_。必填。

示例:

"c_abc123"

enabled
boolean
必填

true 为该爬虫开启自动自我修复,false 保存设置但保持自动自我修复关闭。必填。如需保持关闭,请在此处发送 false,因为此端点之后无法再次调用来关闭它。

示例:

true

sr_threshold
integer
必填

触发自动自我修复的成功率百分比阈值,取值 1 到 70。设置为 50 时,爬虫成功率低于 50% 后即可启动修复任务。必填,无默认值。不接受小数。

必填范围: 1 <= x <= 70
示例:

50

trigger_frequency
enum<string>
必填

Scraper Studio 检查触发规则的频率。per_day 每天检查一次,per_job 在每次作业运行时检查。必填。其他任何值都会返回 HTTP 400。

可用选项:
per_day,
per_job
示例:

"per_day"

min_inputs_threshold
integer | null
默认值:10

触发自动自我修复所需的最少作业输入数量,10 或以上。输入数少于此值的作业不会启动修复任务。使用 trigger_frequency: per_job 时必填。使用 per_day 时可选,且不会使用该值:省略该字段时服务器存储 10,也接受 null。

必填范围: x >= 10
示例:

100

auto_save
boolean
默认值:false

为 true 时,任何成功的修复任务都会将新提取的代码保存到生产环境并更新爬虫的模板版本,无需人工审核。为 false 时,修复任务会运行,但生成的代码不会被保存。默认为 false。

示例:

true

cooldown_period
integer | null
默认值:3

同一爬虫两次连续触发自动自我修复之间的最短等待小时数,1 或以上。发送 null 表示无冷却时间。默认为 3。

必填范围: x >= 1
示例:

5

max_jobs_per_day
integer | null
默认值:8

该爬虫每天允许的最大自动自我修复任务数,取值 1 到 24。发送 null 表示无每日上限。默认为 8。失败的修复任务同样计入此上限,并同样启动冷却期。

必填范围: 1 <= x <= 24
示例:

3

notification_emails
string[]

接收该爬虫自动自我修复通知的电子邮件地址。每个地址都必须属于该爬虫所在账户中的用户。默认为空数组,此时如果 auto_save 为 false,将没有人审核修复结果。

示例:

响应

自动自我修复设置已保存

id
string

已保存的自动自我修复设置的 ID。

示例:

"ash_lz3k9qw1"