Nutzt du unsere API über ein Dedicated Deployment? Ersetze einfach api.langdock.com mit der Basis-URL deines Deployments: <deployment-url>/api/public
Ruft detaillierte Informationen zu einer bestimmten Integration ab, einschließlich ihrer Actions und Konfiguration.
Erforderliche Scopes
Dieser Endpoint erfordert den INTEGRATION_API Scope.
Pfad-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
integrationId | string | Ja | UUID der Integration |
Beispiel
const axios = require("axios");
async function getIntegration(integrationId) {
const response = await axios.get(
`https://api.langdock.com/integrations/v1/${integrationId}`,
{
headers: {
Authorization: "Bearer YOUR_API_KEY"
}
}
);
console.log("Integration:", response.data.integration);
}
getIntegration("550e8400-e29b-41d4-a716-446655440000");
Erfolgreiche Antwort (200 OK)
{
integration: {
id: string;
name: string;
description: string;
authType: string;
authTestCode: string | null;
authFields: Array<object>;
oauthClient: object | null;
actions: Array<{
id: string;
name: string;
slug: string;
description: string;
code: string | null;
order: number;
requiresConfirmation: boolean;
inputFields: Array<{
slug: string;
label: string;
type: string;
description: string;
placeholder: string | null;
required: boolean;
order: number;
options: Array<{label: string, value: string}> | null;
allowMultiSelect: boolean | null;
contextActionId: string | null;
}>;
}>;
triggers: Array<{
id: string;
name: string;
slug: string;
description: string;
}>;
};
}
Fehlerbehandlung
| Status Code | Beschreibung |
|---|
| 400 | Ungültiges Format der Integration-ID |
| 401 | Ungültiger oder fehlender API-Schlüssel |
| 403 | Kein Zugriff auf diese Integration |
| 404 | Integration nicht gefunden |
| 429 | Rate Limit überschritten |
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.