企业用的在线工具一旦超过几个，就会有人问：为什么商店里的每一笔订单都要手工录入会计系统？连接它们有两种办法：一是带现成连接器的集成平台，二是为您的系统编写的定制 API 集成。两种都行。正确的选择取决于业务量、可能出错的程度，以及一年后由谁来维护这个连接。
无代码集成平台擅长什么
Zapier、Make 和 n8n 等平台提供无代码集成：在一个应用中选择触发条件，在另一个应用中选择动作，再映射两者之间的字段。对许多小任务来说，这正是正确答案：
- 业务量低，例如每天有几十条新线索被复制到 CRM。
- 映射简单的单向流程：表单提交变成一项任务，已付款的发票向团队发出一条消息。
- 平台上有维护良好的连接器的应用。
- 企业内部的人无需开发人员就能调整的工作流。
这些平台实际上是以订阅方式出售的 API 集成软件，也是弄清某项自动化到底值不值得做的最快方法。
无代码开始吃力的地方
- 按任务计费。大多数平台按任务或操作的数量收费。每个订单行或库存变动都运行一次的工作流，会随着业务增长而变得昂贵。
- 速率限制。API 会限制客户端可以发送的请求数量，通常以 HTTP 状态码 429（Too Many Requests）作答，该状态码定义于 RFC 6585。繁忙的一天可能使工作流触到这些限制，而且并非每个连接器都会合理地等待并重试。
- 双向同步。让两个系统中的客户或库存保持一致，意味着要决定两边都变化时以谁为准。围绕单向触发构建的连接器很难处理这一点。
- 错误处理。失败的步骤可能只出现在平台的历史记录里，别处都看不到，于是缺失的发票要到月底才被发现。
- 字段缺失。预置连接器只开放常用字段；税码、自定义属性或行级数据可能无法获取。
- 泛滥失控。两年里由不同的人搭建的三十个小工作流，没有任何文档，本身就变成一个无人记录的系统。
什么时候值得做定制 API 集成
当这个连接是企业运转的一部分，而不只是图个方便时，定制开发才合理：
- 业务量很高或在增长，按任务计费已经不划算。
- 数据必须双向保持一致，并为客户、产品、价格和库存明确一个权威数据源。
- 软件有 API，但没有现成的连接器，或者连接器缺少您需要的字段。
- 故障会有后果：订单没发货、发票没开出、库存超卖。
- 您需要可以检查的日志、告警和重试，并且凭据保存在您自己的账户中。
这类 API 开发与集成是一个小型软件项目。它需要字段映射、针对沙盒账户的测试，以及上线后的监控，我们的 API 集成工作就是这样组织的。有些供应商称之为 API 连接服务或中间件；叫什么不如日志和告警重要。洛杉矶 (Los Angeles) 的企业所要求的 API 开发，很多根本不是新建一个公开 API，而是在商店、CRM、会计软件和物流服务之间建立可靠的连接。若专门针对承运商运费、面单和物流跟踪，请参阅物流 API 集成。
混合方案往往是答案
选择很少是非此即彼。常见的模式是：订单、发票和库存等核心流程使用定制代码，而无代码平台留给小型通知和员工喜欢自己调整的一次性任务。有些平台还可以自行托管，让数据和凭据留在您自己的服务器上。重要的是，有人知道每个连接在哪里、用的是哪个账户，以及出故障时会通知谁。
选择之前要先弄清的问题
无论您是聘请 API 集成服务还是自行开发，请先回答这些问题：
- 每天有多少条记录在流动，最忙的一小时又有多少？
- 数据是单向流动，还是两个系统必须保持同步？
- 每种数据以哪个系统的记录为准？
- 如果连接中断一小时、一天或一周，会发生什么？
- 谁来维护，出故障时谁会收到告警？
- API 密钥和 OAuth 授权存放在哪里？它们应当在您自己的账户中创建，而不是承包商的账户中。
常见问题：定制 API 集成
无代码工作流以后可以换成定制代码吗？
可以，而且是一条明智的路径。运行了几个月的工作流记录了真实的需求：哪些字段重要、运行频率如何、在哪里出错。这会让定制版本更快地确定规格。
定制集成比无代码平台更安全吗？
不一定。平台会把许多凭据集中在一个账户里，所以请用强登录方式保护该账户，并限制谁可以编辑工作流。定制集成把凭据保存在您自己的服务器上，只有在该服务器得到维护时才有帮助。
集成应该记录哪些日志？
每一次交换：发送了什么、何时发送、响应以及任何错误，详细到足以重放失败的记录。日志中的个人和支付数据应当被屏蔽，告警应发给指定的人，而不是没人看的共享邮箱。
要连接商店、CRM、会计或物流软件？我们的 API 集成服务会映射系统之间的数据，处理认证、速率限制和重试，记录每一次交换，并在上线前用沙盒账户测试。请告诉我们涉及哪些系统，以及出现新订单、新客户或新发票时应当发生什么。
