跳转到主要内容
WEBHOOK
crawlCompleted
{
  "success": true,
  "type": "crawl.completed",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "webhookId": "a1b2c3d4-0003-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.completed"
​
id
string<uuid>
必填

爬取任务 ID。

​
webhookId
string<uuid>
必填

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

​
data
any[]
必填

空数组。请通过 GET /crawl/{id} 获取结果。

​
metadata
object

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

响应

200

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