Saltearse al contenido
Knot Tools™ Knot Tools™ Knot Tools™ Docs

HTTP y webhooks salientes

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.

El conector HTTP envía solicitudes a API externas o internas. Úselo junto con Dolibarr cuando los datos se encuentren fuera del ERP.

🔌 Métodos y URL

MétodoCaso de uso
GETLeer, comprobar el estado y buscar recursos
CORREOCrear, webhook saliente, carga útil JSON
PONER / PARCHEActualización idempotente en API remota
BORRAREliminación remota (úselo con cuidado)

La URL acepta expresiones:

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

🔌 Encabezados y autenticación

  • Agregue encabezados estáticos (Content-Tipo, Aceptar, ID comerciales).
  • Para claves portadoras o API, vincule una credencial cifrada; nunca pegue secretos en el nodo.
  • Knot aplica medidas de seguridad SSRF documentadas para administradores: las URL locales o privadas pueden bloquearse según la política del servidor.

🔌 Solicitar cuerpo

Plantillas comunes:

  • JSON: la mayoría de las API REST.
  • Formulario: compatibilidad heredada.
  • Sin formato: XML o texto sin formato.

Plantilla JSON con {{ }}:

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

🔌 Respuesta y análisis

Después de la llamada, el nodo normalmente expone:

  • Código de estado HTTP;
  • cuerpo crudo;
  • campos analizados (JSON) para bordes posteriores.

En 4xx/5xx, configure reintentar en el flujo de trabajo o una rama Lógica para registrar y alertar.

🔌 Idempotencia

Para llamadas POST que crean recursos remotos, combine una clave comercial estable con la idempotencia del motor cuando la API del socio lo permita, para evitar duplicados después de reintentar.

Próximos pasos