Rufen Sie die Verbindung nach ID ab

API-Referenz zum Abrufen einer einzelnen Integration Service-Verbindung nach ID mit der Endpunkt-URL, den Pfadparametern und der Beispielantwort.

Ruft eine einzelne Verbindung nach ID ab.

API-Endpunkt

GET BaseURL/v1/Connections/{connectionId}

• Verwenden Sie die Verbindungs-API- Basis-URL für die Cloud-Plattform, auf der Sie sich befinden.

Anforderungsheader

Kopfzeile	Wert
Autorisierung	Inhaber <your-access-token>
X-UIPATH-Konto-ID	<tenant>
X-UIPATH-Ordnerschlüssel	Der Schlüssel des Ordners, der die Verbindungen enthält

Ersetzen Sie alle Werte zwischen den spitzen Klammern <...> durch die entsprechenden Anwendungsfallwerte.

Das Token ist dasjenige, das Sie bei der Autorisierung der externen Anwendung erhalten haben. Es ist 1 Stunde lang verfügbar, dann müssen Sie ein neues generieren oder ein Aktualisierungstoken anfordern. Unter API-Zugriff erfahren Sie, wie Sie eine externe Anwendung registrieren und dieses Token abrufen.

Wichtig:

Externe Anwendungen müssen auf einen einzelnen Ordner abzielen, der durch den X-UIPATH-FolderKey- Header identifiziert wird. Eine Anforderung, bei der der Header weggelassen wird, gibt 400 Bad Request zurück.

Pfadvariablen

Pfadvariable	Datentyp	Beschreibung	Standardwert
Verbindungs-ID (erforderlich)	string	Die ID der Verbindung, die Sie abrufen möchten.	Nicht zutreffend

Abfrageparameter

Abfrageparameter	Datentyp	Beschreibung	Standardwert
Konfigurationen einschließen	boolean	Gibt die Konfiguration der Verbindung zurück. Nur für Aufrufer verfügbar, die den Konfigurationslese-Scope halten. Geheime Werte wie API-Schlüssel und OAuth-Token werden nie zurückgegeben.	false

Antworten

200 OK

{
  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Name": "My Salesforce connection",
  "Connector": {
    "Key": "uipath-salesforce-sfdc",
    "Name": "Salesforce"
  },
  "Folder": {
    "Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "State": "Connected",
  "IsDefault": true,
  "CreateTime": "2026-09-10T10:20:24.485Z",
  "UpdateTime": "2026-09-10T10:20:24.485Z"
}

400 Ungültige Anforderung

Die Anforderung hat den Header „X-UIPATH-FolderKey“ nicht angegeben.

401 Nicht autorisiert

Das Zugriffstoken fehlt, ist abgelaufen oder ungültig.

403 Forbidden

Die externe Anwendung enthält nicht den erforderlichen Scope, oder sie hat keine Connections.View -Berechtigung im angeforderten Ordner.

404 Nicht gefunden

Die Verbindung ist nicht vorhanden, oder sie befindet sich in einem anderen Ordner als dem, auf den die Anforderung ausgerichtet ist. Eine Verbindung außerhalb des angeforderten Ordners gibt 404 zurück, nicht 403.