Zum Hauptinhalt springen
Nutzt du unsere API über ein Dedicated Deployment? Ersetze einfach api.langdock.com mit der Basis-URL deines Deployments: <deployment-url>/api/public
Erstellt einen neuen Trigger für eine Integration. Triggers ermöglichen es Integrationen, Workflows oder Agent-Konversationen basierend auf externen Events zu starten, typischerweise durch Polling eines externen Systems auf Änderungen.

Erforderliche Scopes

Dieser Endpoint erfordert den INTEGRATION_API Scope.

Pfad-Parameter

Request Body

Eingabefeld-Schema

Jedes Eingabefeld hat die folgenden Eigenschaften:

Feldtypen

Beispiel

Antwortformat

Erfolgreiche Antwort (201 Created)

Fehlerbehandlung

Polling-Code-Umgebung

Trigger-Polling-Code läuft in einer isolierten JavaScript-Umgebung mit Zugriff auf:
  • inputs - Objekt mit den Werten der vom Nutzer konfigurierten Eingabefelder
  • secrets - Objekt mit konfigurierten Secrets für die Integration
  • lastPollTime - Zeitstempel des letzten erfolgreichen Polls (für inkrementelles Abrufen)
  • fetch - Standard fetch API für HTTP-Anfragen
  • Standard JavaScript-Built-ins
Der Polling-Code sollte ein Array von Events zurückgeben. Jedes zurückgegebene Event löst den zugehörigen Workflow oder die Agent-Konversation aus.
Polling-Code sollte Fehler sauber behandeln. Unbehandelte Fehler führen dazu, dass der Trigger fehlschlägt und Events möglicherweise verpasst werden.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.