订阅

UiPath Data Service

UiPath Data Service 指南

API 访问权限

概述


使用 Data Service OpenAPI,您可以从所选外部应用程序管理 UiPath Data Service 资源,并且可以通过 Oauth 2.0 授权框架在不共享任何凭据的情况下授权外部应用程序。

Learn how to register the external application in UiPath Automation Suite.

API 权限


要使用 Data Service OpenAPI,您必须向外部应用程序授予 API 权限。这些 API 权限称为作用域,Data Service 有以下三种类型的作用域:

  • DataService.Schema.Read - 此用户作用域允许您的外部应用程序读取租户的 Data Service 架构,此作用域取决于用户的权限。
  • DataService.Data.Read<strong>
  • DataService.Data.Write - 此用户作用域允许您的外部应用程序通过删除、更新或新建数据来编辑租户的 Data Service 数据,此作用域取决于用户的权限。

Learn more about the user roles and permissions in Data Service.

下载 OpenAPI 规范


设置了外部应用程序和用户权限后,您就可以下载租户 Data Service 数据的 OpenAPI 规范。为此,请导航至租户的“Data Service”选项卡右上角的菜单 >“API 访问”>“下载 OpenAPI 文件 (JSON)”。

这样可以获取租户 Data Service 实体的 OpenAPI 3.0 规范(JSON 格式)。单击“复制 OpenAPI 链接”后,系统会复制用于生成租户 Data Service OpenAPI 规范的 API 端点。

授权 API 调用


通过为外部应用程序创建访问令牌,授权外部应用程序使用 Data Service OpenAPI。使用在注册外部应用程序时生成的应用程序 ID 和应用程序密钥。授权方法取决于应用程序的类型(机密或非机密)。

Learn more about the authorization methods for external apps.

API 端点


OAuth2.0 authorization framework helps you generate a access token that allows your external application to make REST API calls to Data Service endpoints, for a limited time (one hour). To continue calling the APIs you need to generate a new access token or request a refresh token.

Data Service API 端点具有以下语法:
HTTP method + BaseURL + The resource category + The Data Service entity + The Operation + Path variables and query parameters

25652565

🚧

Connection limit for file uploads via API

In the Automation Suite-deployed Data Service, each active connection can have only one active file upload API call.
To prevent running into this API limitation, make sure to pass the Connection: close header in your request.

Data Service 实体示例


To describe each API request/response body, we are using the Olympics entity fields created in the Data Service. While we document the generic endpoint, such as Get Entity Records, your endpoint contains the exact name of your entity (for example, Get Olympics Records). The response and request bodies include all the fields from your entity, replicating the entity's structure.

16011601

此外,让我们深入了解每个端点,并发现如何充分利用相应端点。

5个月前更新


API 访问权限


建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。