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
Gibt alle verfügbaren Integrationen in deinem Workspace zurück, einschließlich der von Langdock erstellten Integrationen und deiner benutzerdefinierten Integrationen.

Erforderliche Scopes

Dieser Endpoint erfordert einen der folgenden API Key Scopes:
  • ASSISTANT_API
  • INTEGRATION_API

Beispiel

const axios = require("axios");

async function listIntegrations() {
  const response = await axios.get(
    "https://api.langdock.com/integrations/v1/get",
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  );

  console.log("Integrations:", response.data.integrations);
}

listIntegrations();

Antwortformat

Erfolgreiche Antwort (200 OK)

{
  integrations: Array<{
    id: string;              // UUID der Integration
    name: string;            // Anzeigename
    description: string;     // Integrationsbeschreibung
    authType: string;        // Authentifizierungstyp (z.B. "OAUTH", "API_KEY", "NONE")
    buildByLangdock: boolean; // true, wenn dies eine von Langdock erstellte Integration ist
    actions: Array<{
      id: string;            // UUID der Action
      name: string;          // Anzeigename der Action
      description: string;   // Action-Beschreibung
    }>;
  }>;
}

Beispielantwort

{
  "integrations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Slack",
      "description": "Send messages and interact with Slack",
      "authType": "OAUTH",
      "buildByLangdock": true,
      "actions": [
        {
          "id": "660e8400-e29b-41d4-a716-446655440001",
          "name": "Send Message",
          "description": "Send a message to a Slack channel"
        },
        {
          "id": "660e8400-e29b-41d4-a716-446655440002",
          "name": "Create Channel",
          "description": "Create a new Slack channel"
        }
      ]
    },
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "name": "My Custom Integration",
      "description": "Internal API connector",
      "authType": "API_KEY",
      "buildByLangdock": false,
      "actions": [
        {
          "id": "880e8400-e29b-41d4-a716-446655440001",
          "name": "Get User Data",
          "description": "Retrieves user information"
        }
      ]
    }
  ]
}

Fehlerbehandlung

Status CodeBeschreibung
401Ungültiger oder fehlender API-Schlüssel
429Rate Limit überschritten
500Interner Serverfehler
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.