n8n

n8n es el runner de automatización open-source al que más recurren los developers. Solo necesitas dos nodos integrados: HTTP Request para enviar el job y Webhook para capturar el callback.

URL única — /distill

1. Añade un nodo HTTP Request
2. Method: POST · URL: https://openapi.thunderbit.com/openapi/v1/distill
3. Authentication: Header Auth → Authorization: Bearer YOUR_API_KEY
4. Body (JSON):

{
  "url": "{{ $json.url }}",
  "renderMode": "basic"
}

5. El siguiente nodo recibe {{ $json.data.markdown }}. Pásalo a Notion, Slack, OpenAI, etc.

Batch — /batch/distill + callback Webhook

Los jobs asíncronos son el patrón correcto a partir de 5-10 URLs. Dos workflows:

Workflow A: Submitter

• HTTP Request → POST /openapi/v1/batch/distill
• Body:

{
  "urls": {{ $json.urls }},
  "callback": {
    "url":    "https://your-n8n.example.com/webhook/thunderbit",
    "secret": "whsec_..."
  }
}

Workflow B: Receiver

• Nodo Webhook, path thunderbit
• Verifica el Header X-Thunderbit-Signature contra tu secret (nodo Function, HMAC-SHA256)
• Itera {{ $json.results }} → escribe cada markdown en tu sink

Consejos

• Usa el nodo Wait de n8n + un HTTP Request de polling a /batch/{jobId} si no puedes exponer un Webhook público
• Activa el Continue On Fail del nodo HTTP Request para que un solo 4xx no tire el workflow

Relacionado

• Guía de Webhooks
• Ciclo de vida de un Batch Job
• Zapier · Make.com