Post by account_disabled on Apr 3, 2024 0:12:28 GMT -7
“我们需要整合这两个应用程序”。作为一家拥有 API 开发专业知识和经验的数字咨询公司,这是我们经常听到的一句话。当需求简单并且有可用的本机集成时,对话就很简单。 然而,当没有本机集成时,事情会变得更加复杂,我们需要开始规划如何构建自定义集成的细节。正是在这一点上,我们技术水平较低的客户需要帮助了解集成的组件。很多集成对话都在谈论“使用 API”,因此很容易忘记每个应用程序的 API 只是整体集成的一小部分。 在幕后,需要进行大量数据处理,其中涉及创建“中间件”。本文将帮助您了解 API 集成的核心功能以及可以使用的不同类型的中间件。 API 集成的三个基本功能 任何软件集成都可以分为三个部分: 从源应用程序发送数据负载 将数据处理成目标应用程序接受的格式 将格式化数据推送到目标应用 如果集成需要是双向的,那么您还需要相反的相同行为。 可以将其视为翻译服务,允许两个笔友尽管使用不同的语言进行交流。让我们假设我们生活在前互联网时代,一个意大利人想要向法国人发送信件或从法国人接收信件。在这种情况下: 意大利人用意大利语写一封信并将其邮寄到翻译服务 翻译服务收到意大利人的来信。他们读了这封信,并用法语写了一份翻译副本。 翻译服务将信件的法文副本寄给法国收件人。
法国人收到这封信并且能够阅读它,因为它是用他们的母语写的。 成功的 API 集成以完全相同的方式运行。每个应用程序都以自己的“语言”工作,但依赖中间件将数据转换为正确的格式。 从源应用程序获取数据 从源应用程序捕获数据时,您可以采用两种方法: 选项一:发生更改时从源应用程序推送数据 选项二:按计划从源应用程序中提取数据 一般来说,选项一(推送数据)更可取,因为这可以使两个 希腊 Whatsapp 数据 系统实时同步。拉取数据(选项二)意味着数据仅按照您安排数据拉取过程的频率完全同步。 处理数据 从源应用程序获取数据相对简单。将数据推送到目标应用程序也是一项相当标准的工作。这些操作是使用每个系统的 API 完成的。 集成中较少讨论的方面是数据处理,但这是大部分工作发生的地方。 该数据处理是使用“中间件”进行的。 什么是中间件? 中间件是一个处理输入然后以目标应用程序接受的格式输出的应用程序。该中间件可以是现成的程序(例如Zapier、Integromat或HubSpot Operations Hub),也可以是您通过云服务提供商(例如 Google Cloud、Amazon Web Services 或 Microsoft Azure)托管的自定义代码,或者在您自己的服务器上。 什么是中间件? 无论您使用现成的中间件还是自定义代码,您都需要与了解如何使用该系统接收、处理和传输数据的人员合作。
即使是最简单的集成项目,您也需要执行一些数据处理。以一种集成为例,该集成从一个应用程序获取新联系人的姓名、电子邮件地址和电话号码,并将该数据复制到另一个应用程序。以下是需要进行的一些数据处理的概述: 第一步:从源应用程序的有效负载中找到所需的数据 您的源应用程序将使用其自己的模式以有效负载发送信息。因此,您的中间件将需要: 识别代表名字的有效负载属性 识别代表姓氏的有效负载属性 识别代表电子邮件地址的有效负载属性 识别代表电话号码的有效负载属性 识别表示记录创建日期的有效负载属性 第二步:处理数据 现在您的中间件已识别出所有正确的数据,它需要将其转换为目标应用程序可接受的格式。为了实现这一目标,需要: 将接收到的格式(例如,包括国际拨号代码的完整电话号码)中的电话号码处理为目标应用程序接受的格式(例如,一个属性用于国际拨号代码,另一个属性用于本地化电话号码) 将记录创建日期从接收到的格式(例如 )处理为目标应用程序接受的格式(例如 UTC 日期代码) 删除名字、姓氏和电子邮件地址属性中的空格 验证源应用程序已发送电子邮件数据的电子邮件地址(即数据包含“@”符号、域和 TLD)。如果没有,则触发错误通知过程。 第三步:将所需数据发送到目标应用程序 将数据处理成正确的格式后,您的中间件现在需要将其发送到目标应用程序。因此,中间件需要: 将处理后的数据按照目标应用程序接受的格式排列到单个有效负载中 使用包含负载的 Webhook 触发目标系统的 API 监听目标应用程序的响应 如果目标应用程序发送错误代码,则触发错误处理或错误报告流程。