译者：陈峻
在我们的常见应用中，往往包含着大量服务于各种数据交换的API类型、以及各种常见的API架构与协议。下面，我将从集成的角度和您讨论，在准备将多个服务相互集成时，使用不同类型、架构和协议的API意味着什么?我们可以使用哪些工具，又应该注意什么呢?
API的类型和集成的复杂性
通常，我们有四种常见的API类型：公共、私有、伙伴和复合。其中：
公共API
公共API有时也被称为开放或外部API。顾名思义，任何人都可以公开的方式，在没有限制、或限制相对较少的情况下使用它。此类API通常是方便第三方与本公司开发的Web应用进行通信的一种方式。一些常见的、为大多数中小企业提供服务的公共API有：PandaDoc、BigCommerce、DocuSign、NetSuite等等。
如何与公共API集成
与公共API集成相对比较容易。不同的公司都会为您提供必要的API文档，其中描述了各种端点、验证与授权其API的使用和调用方法等。事实上，大多数企业的集成平台都是围绕着公共API的概念来构建的。他们提供的所谓集成连接器，在本质上都是各个Web应用的API抽象层。不过，它们在工作机制上的复杂性和范围，则取决于API的设计与文档说明。
总的来说，与公共API集成相关的主要策略有两种：要么像iPaaS那样使用第三方软件;要么自行开发。在您选择后者时，请准备好为数据映射(DataMapping)而设计的相应策略。虽然许多应用程序会使用相同的模式，来命名前端的公共字段，但这些字段在后端可能有着截然不同的标签。适当的策略应该能够保证追溯性、准确性和相对快速的项目实施，以及对于一些容易避免的错误予以避免。
值得一提的是，如果您正在为自己的项目寻找一些可公开访问的API，GitHub上就有一个较为详尽的公共API列表。它涵括了诸如天气预报等Web应用所需要用到的、完整的API密钥和OAuth授权。
私有API
作为公共API的对立面，私有API仅适用于单个公司。企业开发人员经常使用它们来实现Web应用之间在某种程度上的数据交换、提供对企业数据库和其他内部共享服务的访问权限、以及与其他内部API通信、或为公司员工构建内部应用。
事实上，越来越多的公司认识到使用自己的API的价值。据此，他们可以节省更多的时间和资源，提高应用的敏捷性和灵活性，并有助于降低整体运营成本。
如何与私有API集成
由于私有API通常驻留在具有高度安全性的环境中，因此与它们的集成需要通过非常严格的防火墙或VPN服务，来发起调用(当然首先需要能够允许外部到访问)。这意味着，如果您想知道本公司的集成中间件是否确实有用，就应该去检查它是否具有某种安全机制/层，去访问本地系统和Web应用。
同样值得注意的是，那些对于公共API的成功至关重要的某些方面，却可能在私有API中显得无关紧要。例如，由于已被假定为受到了公司现有安全策略的保护，因此安全性机制在私有API并不重要。同时，由于开发人员经常在文档中使用内部或技术性的名称，因此版本控制不一定会被包含在设计中。
无论您准备采用手动编码，还是某个集成式中间件，新加入团队的成员或其他部门，在集成私有API时都会面临一些挑战。因此，如果您正在负责设计私有API的话，我建议您像设计公共API那样，去准备好API的各项最佳实践和检查。
伙伴API
伙伴API属于内部API的一个类别，但这些API通常在业务伙伴和B2B客户之间共享，而不是在某个组织内自己使用。此类API的一个常见用例是，在供应链集成或销售点的集成中，连接两个内部业务软件的应用程序。在这种情况下，API往往充当的是经典的EDI(电子数据交换，ElectronicDataInterchange)集成的替代方案。
伙伴API通常具有更加强大的授权、身份验证和安全功能。它们能够允许外部各方去访问某些敏感数据。例如，伙伴CRM或ERP应用的客户数据，或者是医疗机构患者医疗数据等。
如何与伙伴API集成
由于伙伴API不是公开可用的，因此您可能无法找到允许即时“连接”的集成方案。如果您打算集成此类伙伴API的话，就需要提供良好的手动编码、或者去寻找支持自助服务、以及自定义连接器的集成中间件的帮助。
有时您可能需要将伙伴API与基于EDI的Web应用相连接，那么您就需要进行诸如从EDIFACT到JSON的各种数据格式的转换。当然，一个良好的企业集成平台，往往能够支持此类功能。此外，您也可以使用各种专用的解析器，例如：用于UN/EDIFACT文档的Javascript流解析器。
复合API
我个人觉得复合API的使用场景最广泛。例如在购物车中创建订单时，就需要对多个端点进行多次API调用，其中包括：创建新的客户、创建新的订单、向该订单添加新的商品、展示分类商品等。一个复合API往往可以在一次性调用中，完成所有这些工作。这无疑加快了多任务处理的能力和效率。例如，下面是Salesforce的复合RESTAPI的属性文件：
复制
{"
转载请注明：http://www.0431gb208.com/sjszjzl/2180.html
