构建第一个连接器

本节说明如何使用连接器生成器创建连接器，并在自动化中使用该连接器。 该示例介绍了通过手动流程创建连接器，因此我们会自动解决通常可以跳过的点。

我们正在设计的工作流旨在接收有关感兴趣的股票价格的每日 Slack 消息。 POLYGON.IO提供了一组免费的 API，用于检索股票信息，可用于我们的目的。 他们有一个快速注册流程，作为回报，他们会为我们提供 API 密钥，以进行我们需要的 API 调用。

备注：

You can also check out the Building your connector from an API definition section. This explains how to import a Swagger definition and let Connector Builder complete most of the work for you.

注册 POLYGON.IO

大多数供应商应用程序都需要用户名和密码、OAuth 应用程序、API 密钥等形式的身份验证详细信息。Polyzon.io 也不例外。 它提供免费注册以试用其一些 API。

1. 转到Polypoint.io并创建一个帐户。
2. 打开您的仪表板，然后选择“API 密钥”以查看您的密钥。

在连接器生成器中创建连接器

在Automation Cloud ^TM公共部门中，导航至Integration Service ，然后选择“构建连接器” 。

我们从空白连接器开始。 如果您手头有任何形式的 API 定义（Swagger、YAML 等），则可以选择“从 API 定义开始”，让连接器生成器为您完成大部分配置工作。

1. 从网上下载polygon.svg图标，以将其徽标添加到您的目录中。
   备注：

   支持所有图像类型，但我们建议使用方形 SVG。

2. 为自定义连接器添加名称和说明，然后选择“创建” 。

设置身份验证并连接

该多边形入门文档提到，对其平台的任何 API 调用都要求您在标头中发送 API 密钥或将其作为查询参数发送。 为此，您需要将其添加到标头中，如以下示例所述：

1. 在查询字符串中传递 API 密钥，如下所示，其中<your_token>是 API 密钥：

   https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2023-01-09/2023-01-09?apiKey=<your_token>

2. 或者，您可以使用 API 密钥将授权标头添加到请求中作为令牌，如下所示，其中<your_token>是 API 密钥：

   Authorization: Bearer <your_token>

3. 在“连接器生成器”中，导航到“设置” ，然后选择“基本 API ”选项卡。 将“基本 URL ”设置为https://api.polygon.io 。
   注意：在此示例中，我们不会将version "v2"部分添加到基本 URL 中。 这使我们能够运行一些较旧的库存 API 调用。
   
   

   

   
   
4. 接下来，转到“身份验证” 选项卡，从下拉列表中选择您的首选身份验证类型。 对于本示例，我们选择 “个人访问令牌 (PAT)” 。
   备注：

   The Polygon documentation refers to an API key, but given that it has to be sent as Authorization: Bearer <your_token>, it is actually closer to an OAuth style token. Therefore, Personal Access Token (PAT) is technically the better definition. Read more about the different Authentication types.

5. 从“多边形”复制您的 API 密钥，并将“值”设置为： Bearer <your_key> 。
6. 将 “询问用户”字段设置为 “否” ，以便用户在创建与该连接器的连接时不会被要求提供密钥。 这是因为我们不会与租户以外的人共享此连接器。 但是，如果您要共享租户以外的连接器，请不要添加自己的密钥。 将“询问用户”设置为“是” ，以便提示其他用户自己订阅 “多边形”服务。

   “连接器生成器”中预配置的身份验证类型会为您处理大部分工作。 例如，“个人访问令牌”会自动发送“Authorization: Bearer <your_token> ” 作为身份验证标头，而您不必自己构建此配置。

   
   

   

   
   
7. 通过选择“未连接”>“添加连接”按钮，使用上述配置设置连接。 请注意，它如何像任何其他 Integration Service 连接器一样工作。 选择“连接” ，以便您有一个测试连接可用于发出 API 调用。

测试 API 调用

与第三方软件建立连接后，我们将继续执行实际的 API 调用。

1. 导航到左侧面板的“ API” >“新建资源组”。 目标是获取有关给定股票开盘价的每日 Slack 通知。 我们现在要实施的端点是“Polyton 的每日开盘/收盘 API” 。
   
   

   

   
   
2. 在“新建资源组”窗口中，从“多边形文档”中复制端点信息。
3. 将路径设置为/open-close/{stocksTicker}/{date} 。
4. 从“选择方法”列表中，启用“获取记录 (GETBYID) ”，因为我们选择单个对象，而不是对象数组。
5. 提供显示名称，例如股票的开仓 - 收盘。 连接器生成器会自动将{x}变量转换为路径变量。
6. 选择“创建” 以添加此资源。
   
   

   

   
   
   

   

   
   
7. 要测试设置是否正常工作，请选择资源旁边的“发送请求”按钮。 这将创建两个路径参数的值。 我们可以从多边形文档的用法示例中获取它们。
   
   

   

   
   

将连接器发布到目录

您可以采取一些额外的步骤，以使资源和参数的外观和行为都更好。 例如，确定“日期”参数的类型为DateTime ，并提供掩码作为示例。 提供显示名称可使连接器在 Studio 活动中更好地显示。 下图显示了如何设置这些字段：

作为最后一步，选择“发布”以将连接器发布到租户。 该连接器将显示在租户提供的连接器列表中，使用同一租户的任何人都可以使用多边形连接器。

For more information, refer to the detailed Publishing your connector section.

在 UiPath Studio 中使用连接器

只有当您可以在工作流中实际使用构建自定义连接器时，才可以在 Integration Service 中构建自定义连接器。

要在工作流中测试自定义连接器，请执行以下操作：

1. 打开 UiPath Studio 并创建一个新项目。 例如， Slack 每日股价。 由于我们想要接收每日消息，因此此工作流中使用的第一个活动是时间触发器。
2. 接下来，当您将“多边形”活动拖动到画布时，系统会提示您使用帐户连接到Polygoon.io。
3. 建立连接后，配置“多边形” 活动以检索有关 Apple 股票 (AAPL) 的信息。 您可以对感兴趣的股票进行硬编码，但必须将日期格式化为运行时日期。
4. 接下来，添加一个 Slack “向频道发送消息”活动，以将此信息发送到频道。 如果您要将信息发送给自己，请使用“向用户发送消息” 。

注意： Polymon 的 API 一次仅接受一种股票，但您可以将 Studio 配置为通过连接器执行多个调用，并通知 UiPath 的每日股票开盘价 (路径)。