Skip to main content
Nutzt du unsere API über ein Dedicated Deployment? Ersetze einfach api.langdock.com mit der Basis-URL deines Deployments: <deployment-url>/api/public
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.
Das Ändern des authType löscht alle bestehenden Nutzerverbindungen zu dieser Integration. Nutzer müssen sich erneut verbinden.

Erforderliche Scopes

Dieser Endpoint erfordert den INTEGRATION_API Scope.

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.