HTTP und ausgehende Webhooks
Knot Pro Pack erforderlich — Der generische ausgehende HTTP-Connector (
action.http) gehört zur Erweiterung Knot Pro Pack (private Beta, Zugang auf Anfrage, kein öffentlicher Preis), nicht zum kostenlosen Knot Core. Eingehende Webhooks (trigger.webhook) bleiben in Core.
Der HTTP-Connector sendet Anfragen an externe oder interne APIs. Verwenden Sie es zusammen mit Dolibarr, wenn Daten außerhalb des ERP gespeichert sind.
🔌 Methoden und URL
| Method | Use case |
|---|---|
| GET | Read, health check, fetch resource |
| POST | Create, outbound webhook, JSON payload |
| PUT / PATCH | Idempotent update on remote API |
| DELETE | Remote delete (use with care) |
Die URL akzeptiert Ausdrücke:
https://api.example.com/v1/orders/{{ nodes.trigger.output.id }}🔌 Header und Authentifizierung
- Fügen Sie statische Header hinzu („Content-Typ“, „Accept“, Geschäfts-IDs).
- Verknüpfen Sie für Bearer- oder API-Schlüssel einen verschlüsselten Berechtigungsnachweis – fügen Sie niemals Geheimnisse in den Knoten ein.
- Knot wendet für Administratoren dokumentierte SSRF-Sicherheitsmaßnahmen an: Lokale oder private URLs können gemäß Serverrichtlinie blockiert werden.
🔌 Text anfordern
Gängige Vorlagen:
- JSON – die meisten REST-APIs.
- Formular – Legacy-Kompatibilität.
- Rohtext – XML oder einfacher Text.
JSON-Vorlage mit „[object Object]“:
{ "company": "{{ nodes.dolibarr_tier.output.name }}", "amount": {{ nodes.invoice.output.total_ht }}}🔌 Antwort und Analyse
Nach dem Aufruf stellt der Knoten normalerweise Folgendes bereit:
- HTTP-Statuscode;
- roher Körper;
- Geparste Felder (JSON) für nachgeschaltete Kanten.
Konfigurieren Sie unter 4xx/5xx Wiederholung im Workflow oder einem Logic-Zweig zur Protokollierung und Warnung.
🔌 Idempotenz
Kombinieren Sie für POST-Aufrufe, die Remote-Ressourcen erstellen, einen stabilen Geschäftsschlüssel mit der Engine Idempotenz, wenn die Partner-API dies zulässt, um Duplikate nach Wiederholung zu vermeiden.