在我们真正开始集成 Asana 的 API 之前，有一些事情立即引起了我的注意。让我们先来了解一下：

简化的用户界面

您首先会注意到的是优雅的设计。编辑器顶部左侧是连接详细信息、参数和标头，右侧是响应数据。这种有组织的视图可让您在一个地方查看有关 API 的所有详细信息。

您会注意到的第二件事是能够直接从 Studio Pro 向 API 发送测试请求。

让我们详细了解一下这些令人惊叹的功能：

集成 API 时，您将看到几个新功能，以便更轻松地管理您的集成。

首先，您可以为要集成的 API 集合设置一个基本 URL。通过单击“配置和身份验证”，您可以定义用于任何请求的根 URL，对于 Asana 来说，根 URL 是 https://app.asana.com/api/1.0。

定义基本 URL 后，它将作为您从集合中发出的任何请求的前缀，您可以在上面的屏幕中看到它的实际效果。

创建新请求很简单。单击“添加请求”即可在屏幕中打开新请求。要在请求之间导航，请单击“配置和身份验证”与“添加请求”之间的选项卡。您将看到已创建的请求的下拉菜单。

现在添加标题和参数也更加容易了。添加标题时，系统会向您显示常用选项列表。（对于任何不寻常的内容，始终都有“自定义”选项。）

新的用户界面还允许您直接在 Studio Pro 中向端点发送测试请求，而无需运行应用程序。如果您的请求集成正确，响应将显示在右侧的“响应数据”下。

请求成功后，如果当前不存在域模型，Studio Pro 将使用响应数据生成合适的域模型。您也可以随时通过点击“重新创建”为响应重新创建此数据映射。

使用新连接器集成 Asana

GET/工作区

作为实验的一部分，我向 Asana 的工作区端点发出了 GET 请求。此端点返回用户的组织 - Asana 数据结构的根。所有团队、任务和反馈项目都包含在组织结构中。如果没有 GID（工作区或组织的全局标识符），我们就无法继续。

此请求确实需要来自 Asana 的 PAT，因为我选择不为这个简单的实验实施 OAuth。您可以阅读有关如何获取 PAT 的更多信息 请点击此处.

由于这是一个 GET 请求，为了将 PAT 作为请求的一部分发送，我们需要定义授权标头。然后，我们需要发送令牌以及关键字“bearer”来验证我们的用户。

在“标题”下，我单击“新建”，选择“自定义”标题选项，并定义密钥“授权”，值为“Bearer XXX_MyPAT_XXX”。

经过几个操作后，我就可以点击发送来测试我的工作了。它返回了“200 OK”响应，并立即生成了一个可能的域模型，我当时选择生成它。

使用此 GID 和我的 PAT，我现在应该能够集成创建任务端点。

POST/任务

Asana 拥有非常灵活的 API，除了授权的 PAT 和工作区 GID 之外，不需要任何其他信息即可创建任务。其他任何字段都可以留空。任务在创建时将使用这些字段的默认值。

但是，我仍然将设置“name”字符串以及“completed”布尔值和“notes”字符串。

Asana 有一个很酷的 Playground，可以帮助您在查看 API 文档时在右侧构建请求。我只是用它来构建请求的 JSON 主体。我将其粘贴到 Studio Pro 中的“Body”字段中，然后单击“使用 JSON 片段”。Asana 解释了数据并在 Body Structure 下创建了一个可能的模型，我选择应用该模型。

之后我很好奇，点击了发送。Studio Pro 立即返回了“201 Created”响应。然后我使用这些数据为响应生成域模型，该模型将在实施后保存实际数据。

现在唯一要做的就是在微流中调用此服务。您可以在工具箱中的“集成活动”下找到“发送 REST 请求”操作。将其拖入流程后，您唯一需要做的就是选择 REST 服务，在我们的例子中是“CreateTask”请求。

之后它唯一需要做的就是使用我们为 API 定义的实体来创建数据。

我们可以像平常一样创建实体，记住设置彼此之间的关联。然后我们只需将数据提供给“发送 REST 请求”操作。

结语

总体而言，我发现使用新连接器非常直观。虽然我认为集成是我的专长，但即使是该领域的新手也可以毫无困难地学会使用它。

另一方面，开发人员在 Mendix 集成人员会发现这是组织和实施工作的一种更清洁、更有效的方式。

正如我所提到的，该连接器处于测试阶段。它目前不支持 PUT 或 DELETE 操作，我们仍在努力添加为不同身份验证类型设置常量的功能，以提高灵活性和安全性。

总而言之，我喜欢这个新的连接器，它对我们在 REST 中的工作方式进行了令人耳目一新的改变。 Mendix.