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
Die Integrations API ermöglicht es dir, benutzerdefinierte Integrationen in deinem Langdock Workspace programmatisch zu erstellen und zu verwalten. Baue Integrationen, die sich mit deinen internen Tools, APIs und Services verbinden.

API Key Scopes

Die Integrations API erfordert bestimmte API Key Scopes:
ScopeEndpoints
ASSISTANT_API oder INTEGRATION_APIIntegrationen auflisten (GET /integrations/v1/get)
INTEGRATION_APIAlle anderen Integration-Endpoints
Erstelle einen API Key mit dem INTEGRATION_API Scope in deinen Workspace-Einstellungen, um auf die vollständige Integrations API zuzugreifen.

Verfügbare Endpoints

Integrationen

MethodeEndpointBeschreibung
GET/integrations/v1/getAlle Integrationen auflisten
POST/integrations/v1/createNeue Integration erstellen
GET/integrations/v1/{integrationId}Integration-Details abrufen
PATCH/integrations/v1/{integrationId}Integration aktualisieren
PATCH/integrations/v1/{integrationId}/authAuth-Konfiguration aktualisieren

Actions

Actions sind Fähigkeiten, die du zu Integrationen hinzufügen kannst und die Agents ausführen können.
MethodeEndpointBeschreibung
POST/integrations/v1/{integrationId}/actions/createAction erstellen
PUT/integrations/v1/{integrationId}/actions/{actionId}Action aktualisieren
DELETE/integrations/v1/{integrationId}/actions/{actionId}Action löschen

Triggers

Triggers ermöglichen es Integrationen, Workflows oder Agent-Konversationen basierend auf externen Events zu starten.
MethodeEndpointBeschreibung
POST/integrations/v1/{integrationId}/triggers/createTrigger erstellen
PUT/integrations/v1/{integrationId}/triggers/{triggerId}Trigger aktualisieren
DELETE/integrations/v1/{integrationId}/triggers/{triggerId}Trigger löschen

Schnellstart

So erstellst du eine einfache Integration mit einer Action:
const axios = require("axios");

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.langdock.com";

// 1. Create an integration
const integrationResponse = await axios.post(
  `${BASE_URL}/integrations/v1/create`,
  {
    name: "My Custom Integration",
    description: "Connects to my internal API"
  },
  {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    }
  }
);

const integrationId = integrationResponse.data.integration.id;

// 2. Add an action to the integration
const actionResponse = await axios.post(
  `${BASE_URL}/integrations/v1/${integrationId}/actions/create`,
  {
    name: "Get User Data",
    description: "Retrieves user information from the internal API",
    code: `
      const response = await fetch('https://my-api.example.com/users/' + inputs.userId);
      return await response.json();
    `,
    inputFields: [
      {
        label: "User ID",
        type: "TEXT",
        description: "The ID of the user to retrieve",
        required: true
      }
    ]
  },
  {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    }
  }
);

console.log("Action created:", actionResponse.data.action);

Anwendungsfälle

  • Interne Tools anbinden: Verbinde Agents mit den internen APIs, Datenbanken oder Services deines Unternehmens
  • Benutzerdefinierte Workflows: Baue Integrationen, die Workflows basierend auf externen Events auslösen
  • Datenanreicherung: Erstelle Actions, die Daten aus mehreren Quellen abrufen und anreichern
  • Automatisiertes Reporting: Baue Integrationen, die Berichte generieren und verteilen

Rate Limits

Die Integrations API folgt den Standard-Rate-Limits. Wenn du das Limit überschreitest, erhältst du eine 429-Antwort. Warte und versuche es mit exponentiellem Backoff erneut.
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.