跳转到主要内容
WEBHOOK
batchScrapeStarted
{
  "success": true,
  "type": "batch_scrape.started",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "webhookId": "b2c3d4e5-0001-0000-0000-000000000000",
  "data": [],
  "metadata": {}
}

请求头

​
X-Firecrawl-Signature
string

原始请求体的 HMAC-SHA256 签名，格式为 sha256=<hex>。当你在账户设置中配置了 HMAC 密钥时，该字段会出现。有关验证详情，请参阅 Webhook 安全。

示例:

"sha256=abc123def456789..."

请求体

application/json
​
success
boolean
必填
​
type
string
必填
Allowed value: "batch_scrape.started"
​
id
string<uuid>
必填

批量抓取任务 ID，与 POST /batch/scrape 返回的 id 一致。

​
webhookId
string<uuid>
必填

此次 webhook 投递的唯一标识符。

​
data
any[]
必填
​
metadata
object

你在 webhook 配置中提供的自定义元数据对象。每次投递时都会原样返回。

响应

200

返回任意 2xx 状态码以确认已接收。