内部 API vs 公共 API：全面比较及管理策略

原文链接：https://document360.com/blog/internal-vs-external-apis/

内部和公共 API 在受众和使用场景上有所不同。公司内部利益相关者使用内部 API 是其工作职责的一部分，目的在于提高内部生产力和效率。而公共 API 则可以创造收入，树立开源产品的公司品牌，或着持续改进 API。

公共 API

企业通过公共 API 为大众提供一个标准化且安全的接口，用于访问其数据来构建应用程序。这些 API 向公众利益相关者开放，如外部开发人员、第三方供应商和客户，并支持通过互联网使用 HTTP 协议进行访问。外部 API 通常会提供特定的功能或服务，如访问数据或执行事务。

关于外部 API 的一些要点：

• 对公众开放
• 比内部 API 更多地用于创建用户界面
• 创造收入或提高品牌知名度
• 收集使用情况指标以改进 API
• 管理后端组件之间的交互
• 有助于与其他业务应用程序集成

内部 API

内部 API 可以提高运营效率。公司内会使用内部 API 来访问公司未向公众公开的敏感内部系统和数据。与公共 API 不同，内部 API 的功能高度专业化，并不适用于一般用途，因此内部 API 很少用于创建用户界面。

公司使用内部 API 作为由不同组织开发团队构建的组件的接口，这些团队在不同的组件上工作。此外，它们还使用内部 API 作为允许组件之间通信的接口。公司还会创建 API 作为独立组件，以实现特定功能，而不仅仅是作为“连接器”。

关于内部 API 的一些要点：

• 不在互联网上公开
• 仅在公司或开发团队内部创建和使用
• 可能为内部利益相关者提供敏感数据的访问权限
• 专注于特殊的功能，而不是通用的
• 用于连接微服务架构中的组件
• 处理后端服务，而不是创建用户界面

公共 API 的优势

• 收入： 通过向第三方应用开发人员公开数据，公共 API 有可能创造收入。
• 品牌知名度： 无论 API 是否产生收入，企业将其 API 公开，都可以提高其品牌知名度。此外，由于 API 适合普通用户，因此其覆盖范围可以扩展到开发人员以外的业务利益相关者和公民开发人员。
• 社区建设： 企业可以围绕其公共 API 建立一个不断发展的公司。社区可以为每个版本的新功能提供建议，并提供一个持续的反馈循环。