跳转到主要内容
WEBHOOK
agentAction
{
  "success": true,
  "type": "agent.action",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "webhookId": "d4e5f6a7-0002-0000-0000-000000000000",
  "data": [
    {
      "creditsUsed": 5,
      "action": "scrape",
      "input": {
        "url": "https://example.com"
      }
    }
  ],
  "metadata": {}
}

请求头

X-Firecrawl-Signature
string

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

示例:

"sha256=abc123def456789..."

请求体

application/json
success
boolean
必填
type
string
必填
Allowed value: "agent.action"
id
string<uuid>
必填

代理任务 ID。

webhookId
string<uuid>
必填

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

data
object[]
必填

仅包含一个对象的数组,用于描述所执行的操作。

metadata
object

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

响应

200

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