获取连接

API 参考，用于在文件夹中列出 Integration Service 连接，其中包含端点 URL、所需标头和示例响应。

在文件夹中检索连接。

API 端点

GET BaseURL/v1/Connections

• 使用您所在云平台的连接 API基本 URL 。

请求标头

页眉	值
授权	承载 <your-access-token>
X-UIPATH-帐户 ID	<tenant>
X-UIPATH-文件夹密钥	保存连接的文件夹键

将尖括号 <...> 之间的所有值替换为其相应的用例值。

<your-access-token> 是您在授权外部应用程序时收到的 。有效期为 1 小时，然后您需要生成新令牌，或请求刷新令牌。有关如何注册外部应用程序并获取此令牌的信息，请参阅API 访问权限。

重要提示：

外部应用程序必须以由X-UIPATH-FolderKey标头标识的单个文件夹为目标。省略标头或将 allFolders 设置为 true 的请求将返回 400 Bad Request。

查询参数

查询参数	数据类型	描述	默认值
所有文件夹	boolean	不支持外部应用程序。将其设置为 true 会返回 400 Bad Request。	false

响应

200 OK

返回所请求文件夹中的连接。对外部应用程序的响应不包括连接所有者、元素实例 ID、轮询间隔和“自带应用程序”标志。

[
  {
    "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 Bad Request

请求未提供X-UIPATH-FolderKey标头，或者将allFolders设置为true 。外部应用程序的每个请求必须针对一个文件夹。

401 未经授权

访问令牌缺失、过期或无效。

403 Forbidden

外部应用程序不具备所需的作用域，或者在请求的文件夹中没有Connections.View权限。