跳转到主要内容
WEBHOOK
agentFailed
{
  "success": false,
  "type": "agent.failed",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "webhookId": "d4e5f6a7-0004-0000-0000-000000000000",
  "data": [
    {
      "creditsUsed": 8
    }
  ],
  "error": "Max credits exceeded",
  "metadata": {}
}

请求头

X-Firecrawl-Signature
string

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

示例:

"sha256=abc123def456789..."

请求体

application/json
success
boolean
必填

对于此事件,该值始终为 false

type
string
必填
Allowed value: "agent.failed"
id
string<uuid>
必填

代理任务 ID。

webhookId
string<uuid>
必填

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

data
object[]
必填
error
string
必填

描述故障原因的、便于人工阅读的错误消息。

metadata
object

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

响应

200

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