Webhooks HTTP e de saída
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.
O conector HTTP envia solicitações para APIs externas ou internas. Use-o junto com Dolibarr quando os dados estiverem fora do ERP.
🔌 Métodos e URL
| Método | Caso de uso |
|---|---|
| GET | Ler, verificar a integridade, buscar recursos |
| PUBLICAR | Criar, webhook de saída, carga útil JSON |
| COLOQUE / PATCH | Atualização idempotente na API remota |
| EXCLUIR | Exclusão remota (use com cuidado) |
O URL aceita expressões:
https://api.example.com/v1/orders/{{ nodes.trigger.output.id }}🔌 Cabeçalhos e autenticação
- Adicione cabeçalhos estáticos (
Content-Tipo,Accept, IDs de negócios). - Para chaves de portador ou de API, vincule uma credencial criptografada — nunca cole segredos no nó.
- Knot aplica proteções SSRF documentadas para administradores: URLs locais ou privados podem ser bloqueados por política do servidor.
🔌 Solicitar corpo
Modelos comuns:
- JSON — a maioria das APIs REST.
- Formulário — compatibilidade legada.
- Bruto — XML ou texto simples.
Modelo JSON com {{ }}:
{ "company": "{{ nodes.dolibarr_tier.output.name }}", "amount": {{ nodes.invoice.output.total_ht }}}🔌 Resposta e análise
Após a chamada, o nó normalmente expõe:
- Código de status HTTP;
- corpo cru;
- campos analisados (JSON) para bordas downstream.
Em 4xx/5xx, configure nova tentativa no fluxo de trabalho ou em uma ramificação Logic para registrar e alertar.
🔌 Idempotência
Para chamadas POST que criam recursos remotos, combine uma chave de negócios estável com idempotência do mecanismo quando a API do parceiro permitir, para evitar duplicatas após nova tentativa.