Aller au contenu
Knot Tools™ Knot Tools™ Knot Tools™ Docs

HTTP et webhooks sortants

Knot Pro Pack requis — depuis Knot Core V2.8.1, le connecteur HTTP sortant générique (action.http) est fourni par l’extension Knot Pro Pack (bêta privée, accès sur demande, aucun prix public), pas par Knot Core gratuit. Les webhooks entrants (trigger.webhook) restent dans Core.

Le connector HTTP envoie des requêtes vers des API externes ou internes. Il complète le connector Dolibarr quand la donnée n’est pas dans l’ERP.

🔌 Méthodes et URL

MéthodeCas d’usage
GETLecture, health-check, récupération de ressource
POSTCréation, webhook sortant, payload JSON
PUT / PATCHMise à jour idempotente côté API distante
DELETESuppression distante (avec prudence)

L’URL accepte des expressions :

https://api.example.com/v1/orders/{{ nodes.trigger.output.id }}
Cliquer pour agrandir
Inspecteur du node HTTP GET avec URL api.example.com

🔌 Headers et authentification

  • Ajoute des headers statiques (Content-Type, Accept, identifiants métier).
  • Pour Bearer ou clé API, lie un credential chiffré — ne colle jamais de secret en clair dans le node.
  • Knot applique les garde-fous SSRF documentés côté admin : les URL locales ou privées peuvent être bloquées selon la politique serveur.

🔌 Corps de requête (body)

Modèles courants :

  • JSON — le plus fréquent pour les API REST.
  • Form — compatibilité legacy.
  • Raw — XML ou texte libre.

Tu peux templater le JSON avec {{ }} :

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

🔌 Réponse et parsing

Après la requête, le node expose typiquement :

  • code HTTP ;
  • corps brut ;
  • champs parsés (JSON) pour les edges suivants.

En cas d’erreur 4xx/5xx, configure un retry sur le workflow ou une branche Logic pour journaliser et alerter.

🔌 Idempotence

Pour les POST qui créent des ressources distantes, combine une clé métier stable et la idempotence du moteur quand l’API partenaire le permet, afin d’éviter les doublons après retry.

Suite