Saltar al contenido principal
WEBHOOK
crawlStarted
{
  "success": true,
  "type": "crawl.started",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "webhookId": "a1b2c3d4-0001-0000-0000-000000000000",
  "data": [],
  "metadata": {}
}

Encabezados

​
X-Firecrawl-Signature
string

Firma HMAC-SHA256 del cuerpo sin procesar de la solicitud, con el formato sha256=<hex>. Está presente cuando se configura un secreto HMAC en la configuración de tu cuenta. Consulta Seguridad de webhooks para obtener más detalles sobre la verificación.

Ejemplo:

"sha256=abc123def456789..."

Cuerpo

application/json
​
success
boolean
requerido

Siempre es true para este evento.

​
type
string
requerido

El tipo de evento.

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

El ID del trabajo de rastreo, que coincide con el id devuelto por POST /crawl.

​
webhookId
string<uuid>
requerido

Identificador único de esta entrega de webhook. Úsalo para la deduplicación: se envía el mismo valor en los reintentos.

​
data
any[]
requerido

Array vacío para este evento.

​
metadata
object

El objeto de metadatos personalizado que proporcionaste en la configuración del webhook. Se devuelve en cada entrega.

Respuesta

200

Devuelve cualquier código de estado 2xx para confirmar la recepción.