Salta ai contenuti
Knot Tools™ Knot Tools™ Knot Tools™ Docs

Webhook HTTP e in uscita

Knot Pro Pack required — The generic outgoing HTTP connector (action.http) is provided by the Knot Pro Pack extension (private beta, access on request, no public price), not by the free Knot Core. Incoming webhooks (trigger.webhook) stay in Core.

Il connettore HTTP invia richieste ad API esterne o interne. Usalo insieme a Dolibarr quando i dati risiedono al di fuori dell’ERP.

🔌 Metodi e URL

MetodoCaso d’uso
GETLeggi, controlla lo stato, recupera risorse
INVIARECrea webhook in uscita, payload JSON
METTI / PATCHAggiornamento idempotente sull’API remota
ELIMINAREEliminazione remota (usare con cautela)

L’URL accetta espressioni:

https://api.example.com/v1/orders/{{ nodes.trigger.output.id }}
Click to enlarge
HTTP GET node inspector with api.example.com URL

🔌 Intestazioni e autenticazione

  • Aggiungi intestazioni statiche (“Content-Tipo”, “Accetta”, ID aziendali).
  • Per le chiavi Bearer o API, collega una credenziale crittografata: non incollare mai segreti nel nodo.
  • Knot applica le protezioni SSRF documentate per gli amministratori: gli URL locali o privati ​​possono essere bloccati in base alla politica del server.

🔌Richiedi corpo

Modelli comuni:

  • JSON: la maggior parte delle API REST.
  • Form: compatibilità legacy.
  • Raw: XML o testo semplice.

Modello JSON con {{ }}:

{
  "company": "{{ nodes.dolibarr_tier.output.name }}",
  "amount": {{ nodes.invoice.output.total_ht }}
}

🔌 Risposta e analisi

Dopo la chiamata, il nodo tipicamente espone:

  • Codice di stato HTTP;
  • corpo grezzo;
  • campi analizzati (JSON) per i bordi downstream.

Su 4xx/5xx, configura Riprova sul flusso di lavoro o su un ramo Logica per registrare e avvisare.

🔌 Idempotenza

Per le chiamate POST che creano risorse remote, combina una chiave aziendale stabile con l’idempotenza del motore quando l’API del partner lo consente, per evitare duplicati dopo il riprova.

Prossimi passi