n8n

n8n est l'outil d'automatisation open-source que la plupart des développeurs choisissent. Deux nœuds intégrés suffisent : HTTP Request pour soumettre un job, Webhook pour capter le callback.

URL unique — /distill

1. Ajoute un nœud HTTP Request
2. Méthode : POST · URL : https://openapi.thunderbit.com/openapi/v1/distill
3. Authentification : Header Auth → Authorization: Bearer YOUR_API_KEY
4. Body (JSON) :

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

5. Le nœud suivant reçoit {{ $json.data.markdown }}. Branche vers Notion, Slack, OpenAI, etc.

Batch — /batch/distill + callback Webhook

Les jobs asynchrones sont le bon pattern au-delà de 5 à 10 URLs. Deux 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œud Webhook, chemin thunderbit
• Vérifie le Header X-Thunderbit-Signature contre ton secret (nœud Function, HMAC-SHA256)
• Itère {{ $json.results }} → écris chaque markdown dans ton sink

Astuces

• Utilise le nœud Wait de n8n + un HTTP Request de polling vers /batch/{jobId} si tu ne peux pas exposer un Webhook public
• Active Continue On Fail sur le nœud HTTP Request pour qu'un seul 4xx ne tue pas le workflow

Liens connexes

• Guide Webhooks
• Batch Job Lifecycle
• Zapier · Make.com