Skip to main content
Konfiguriert die Authentifizierungsmethode für eine Integration. Damit legst du fest, wie sich Nutzer mit dem externen Service verbinden — per API Key, OAuth, Service Account oder ohne Authentifizierung.

Bevor du startest

  • Änderung des authType: Das Ändern des authType löscht alle bestehenden Nutzerverbindungen zu dieser Integration. Nutzer müssen sich erneut verbinden.

Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

Erforderliche Scopes

Dieser Endpoint erfordert den INTEGRATION_API Scope.

Parameter

Pfad-Parameter

Request Body

Auth-Typen

Auth-Feld-Schema

Jedes Auth-Feld definiert ein Eingabefeld, das Nutzer beim Verbinden mit der Integration ausfüllen.
Der slug muss innerhalb der Integration eindeutig sein. Die Feld-id wird automatisch generiert — füge sie nicht in den Request ein.

Feldtypen

OAuth-Client-Schema

Nur relevant, wenn authType OAUTH oder OAUTH_DCR ist.
OAuth-Zugangsdaten (clientId, clientSecret, authUrl, tokenUrl) sind nur schreibbar — sie werden nie in API-Antworten zurückgegeben.

Beispiel: API-Key-Authentifizierung

Antwortformat

Erfolgreiche Antwort (200 OK)

Verhalten

  • Auth-Felder werden bei jedem Aufruf komplett ersetzt — das gesamte Array wird gelöscht und neu erstellt.
  • Das Ändern des authType löscht alle bestehenden Nutzerverbindungen und jede vorherige OAuth-Client-Konfiguration.
  • Das Setzen von authType auf NONE, API_KEY oder SERVICE_ACCOUNT löscht jeden vorhandenen OAuth-Client.
  • OAuth-Zugangsdaten (clientId, clientSecret) werden vor der Speicherung verschlüsselt.

Fehlerbehandlung

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.