n8n

n8n é o runner de automação open-source que a maioria dos desenvolvedores usa primeiro. Dois nós embutidos são tudo o que você precisa: HTTP Request para submeter um job, Webhook para capturar o callback.

URL única — /distill

1. Adicione um nó 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. O próximo nó recebe {{ $json.data.markdown }}. Encaminhe para Notion, Slack, OpenAI, etc.

Batch — /batch/distill + callback de Webhook

Jobs assíncronos são o padrão certo a partir de 5-10 URLs. Dois 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

• Nó Webhook, path thunderbit
• Verifique o Header X-Thunderbit-Signature contra o seu secret (nó Function, HMAC-SHA256)
• Itere {{ $json.results }} → grave cada markdown no seu destino

Dicas

• Use o nó Wait do n8n + um HTTP Request de polling em /batch/{jobId} se você não puder expor um webhook público
• Defina Continue On Fail no nó HTTP Request para que um único 4xx não mate o workflow

Relacionados

• Guia de Webhooks
• Batch Job Lifecycle
• Zapier · Make.com