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

请求头

​
X-Firecrawl-Signature
string

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

示例:

"sha256=abc123def456789..."

请求体

application/json
​
success
boolean
必填

对于此事件，该值始终为 true。

​
type
string
必填

事件类型。

Allowed value: "crawl.started"
​
id
string<uuid>
必填

爬取任务 ID，与 POST /crawl 返回的 id 一致。

​
webhookId
string<uuid>
必填

此次 Webhook 投递的唯一标识符。可用于去重——重试时会发送相同的值。

​
data
any[]
必填

此事件中为空数组。

​
metadata
object

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

响应

200

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