构建第一个连接器

本页将指导您使用连接器生成器手动创建连接器，并在自动化中使用该连接器。我们将通过手动流程介绍创建过程，因此我们会自动涵盖并解决通常可以跳过的点。例如，我们将导入一个 Swagger 定义，连接器生成器将为您完成大部分工作。

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

注册 POLYGON.IO

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

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

在 Automation Cloud 中，导航到Integration Service ，然后单击目录中的第一个图块，该图块称为“构建新连接器，并从“空白连接器”开始。从网上下载polygon.svg图标，以将其徽标添加到您的目录中。

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

如果您手头有任何形式的 API 定义 (Swagger、YAML 等)，则可以从第一个图块开始，让连接器生成器为您完成大部分配置工作。
docs image

设置身份验证并连接

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

在查询字符串中传递 API 密钥，如下所示：

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

其中<your_token>是 API 密钥。

或者，您可以使用 API 密钥将“授权”标头添加到请求中作为令牌，格式如下：

Authorization: Bearer <your_token>Authorization: Bearer <your_token>

其中<your_token>是 API 密钥。

在“连接器生成器”中，导航到“设置”>“基本 API” ，您必须在其中填写“基本 URL ”并将其设置为https://api.polygon.io 。

注意：在此示例中，我们不会将version "v2"部分添加到基本 URL，因为这使我们可以运行一些较旧的库存 API 调用。

在“设置” >“身份验证”下，将“身份验证类型” 下拉列表设置为“个人访问令牌 (PAT)” 。多边形文档引用了API 密钥，但鉴于它必须作为Authorization: Bearer <your_token>发送，它实际上更接近于 OAuth 样式令牌，因此从技术上讲， PAT是更好的定义。在文档中阅读有关身份验证类型的更多信息。

在屏幕截图中，我们将密钥设置为value并进行设置，以便系统不会要求用户提供密钥，因为我们不会与租户以外的用户共享此连接器。但是，如果您要与租户以外的用户共享连接器，则不要添加自己的密钥，而保留Ask the user: yes ，以便提示他们自己订阅“多边形” 服务。

“连接器生成器”中预配置的身份验证类型会为您处理大部分工作。例如，我们当前配置的Personal Access Token会自动发送Authorization: Bearer <your_token>作为身份验证标头，而您不必自己构建此配置。
docs image

通过单击屏幕右上角的未连接> 添加连接，使用上述配置设置连接。请注意，这与任何其他 Integration Service 连接器一样。单击“连接”，创建一个用于执行 API 调用的测试连接。

测试 API 调用

与第三方软件建立连接后，我们将继续执行实际的 API 调用。导航至左侧面板，选择“ API” >“新建资源组”。目标是获取有关给定股票开盘价的每日 Slack 通知。我们现在要实施的端点是“多边形的每日开盘/收盘API”。

在创建新资源组的模式下，从多边形文档中复制您在屏幕上看到的内容。

将路径设置为/open-close/{stocksTicker}/{date}并在“方法”下选择“ Get record (GETBYID) ”，因为我们选择了“ single object ”而不是对象数组。提供显示名称，例如为股票提供“打开-关闭”名称。连接器生成器会自动将{x}变量转换为路径变量。
docs image

要测试所执行的设置是否正常工作，请单击顶部的Send request 。这将创建两个路径参数的值。我们可以从多边形文档的用法示例中获取它们。
docs image

将连接器发布到目录

您可以采取一些额外的步骤，以使资源和参数看起来更好，表现更好。标识Date参数的类型为DateTime ，并提供掩码作为示例。提供Display names将使您的连接器在 Studio 活动中显示得更好。您可以在下面的屏幕截图中看到一个示例：
docs image

最后一步，点击“发布”，将连接器发布到租户。连接器将显示在租户提供的连接器列表中，使用同一租户的任何人都可以查看和使用多边形连接器。
docs image

在 Studio 中使用连接器

只有当您可以实际使用连接器时，让连接器出现在 Integration Service 中才有意义。导航到您首选项的 Studio 设计器，然后创建一个新项目。在此示例中，我们将使用 Studio Web，并将项目命名为Slack每日股票价格，也将其设为每日事件。由于我们想要接收每日消息，因此此工作流中使用的第一个活动是时间触发器。