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
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

ParameterTypErforderlichBeschreibung
integrationIdstringJaUUID 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");

Antwortformat

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;
      order: number;
    }>;
    triggers: Array<{
      id: string;
      name: string;
      slug: string;
      description: string;
    }>;
  };
}

Fehlerbehandlung

Status CodeBeschreibung
400Ungültiges Format der Integration-ID
401Ungültiger oder fehlender API-Schlüssel
403Kein Zugriff auf diese Integration
404Integration nicht gefunden
429Rate 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.