Bevor du startest
- Änderung des
authType: Das Ändern desauthTypelöscht alle bestehenden Nutzerverbindungen zu dieser Integration. Nutzer müssen sich erneut verbinden.
Basis-URL
Erforderliche Scopes
Dieser Endpoint erfordert denINTEGRATION_API Scope.
Parameter
Pfad-Parameter
Request Body
Auth-Typen
OAUTH_DCR und OAUTH_CIMD werden von MCP-Integrationen verwendet und lassen sich über diesen Endpunkt nicht setzen. Requests mit einem dieser Werte geben 400 zurück.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, wennauthType OAUTH ist. Deine Skripte für authorizationCode und accessTokenCode erhalten PKCE-Werte. Siehe Authorization Code mit PKCE.
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
authTypelöscht alle bestehenden Nutzerverbindungen und jede vorherige OAuth-Client-Konfiguration. - Das Setzen von
authTypeaufNONE,API_KEYoderSERVICE_ACCOUNTlöscht jeden vorhandenen OAuth-Client. - OAuth-Zugangsdaten (
clientId,clientSecret) werden vor der Speicherung verschlüsselt. authFieldValuesersetzt die gespeicherten Standardwerte beiOAUTH, sobald du das Objekt sendest. Ohne die Eigenschaft bleiben die Werte erhalten. Unbekannte oder leere Schlüssel fallen weg.PASSWORD-Werte werden verschlüsselt und als***********zurückgegeben. Sende diese Maske, um das gespeicherte Geheimnis zu behalten. Andere Werte kommen als Text zurück. Die Antwort lässtauthFieldValuesweg, wenn nichts gespeichert ist.
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.