Verbindungen abrufen

API-Referenz zum Auflisten von Integration Service-Verbindungen in einem Ordner, mit der Endpunkt-URL, den erforderlichen Headern und der Beispielantwort.

Ruft die Verbindungen in einem Ordner ab.

API-Endpunkt

GET BaseURL/v1/Connections

• 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 <your-access-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, die den Header weglässt oder die allFolders auf true festlegt, gibt 400 Bad Request zurück.

Abfrageparameter

Abfrageparameter	Datentyp	Beschreibung	Standardwert
Alle Ordner	boolean	Nicht für externe Anwendungen unterstützt. Wenn Sie ihn auf true festlegen, wird 400 Bad Request zurückgegeben.	false

Antworten

200 OK

Gibt die Verbindungen im angeforderten Ordner zurück. Antworten auf eine externe Anwendung schließen den Verbindungsinhaber, die Elementinstanz-ID, das Abrufintervall und das Bring-Your-Own-App-Flag aus.

[
  {
    "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 oder allFolders wurde auf true festgelegt. Externe Anwendungen müssen einen Ordner pro Anforderung anvisieren.

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.