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:
| Scope | Endpoints |
|---|
ASSISTANT_API oder INTEGRATION_API | Integrationen auflisten (GET /integrations/v1/get) |
INTEGRATION_API | Alle 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
| Methode | Endpoint | Beschreibung |
|---|
GET | /integrations/v1/get | Alle Integrationen auflisten |
POST | /integrations/v1/create | Neue Integration erstellen |
GET | /integrations/v1/{integrationId} | Integration-Details abrufen |
PATCH | /integrations/v1/{integrationId} | Integration aktualisieren |
PATCH | /integrations/v1/{integrationId}/auth | Auth-Konfiguration aktualisieren |
Actions
Actions sind Fähigkeiten, die du zu Integrationen hinzufügen kannst und die Agents ausführen können.
| Methode | Endpoint | Beschreibung |
|---|
POST | /integrations/v1/{integrationId}/actions/create | Action 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.
| Methode | Endpoint | Beschreibung |
|---|
POST | /integrations/v1/{integrationId}/triggers/create | Trigger 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.