https://document360.com/blog/public-api-launch/

在这个数字世界中，大多数软件应用程序都是通过 SaaS 模型交付的，即通过 Web 浏览器而不是桌面客户端访问应用程序。客户通过前端与 SaaS 应用程序交互并进行增值活动。应用程序编程接口 (API) 帮助公司释放其软件套件的全部潜力。公共 API 可帮助公司将其软件与客户可能用于其他目的的其他软件工具集成。这些基于 API 的集成为您的客户建立了信任因素，即您的软件应用程序可以帮助他们与其他应用程序进行数据交换。

公共 API 还可以帮助客户自动执行应用程序中的许多日常任务。一旦购买了软件应用程序，客户就会围绕它们构建许多业务流程来开展增值活动。这些平凡的任务可以使用 API 轻松实现自动化。有一些第三方工作流程自动化工具，例如Zapier 、 Make 、Workato 等，可用于自动化日常重复性活动。

该公司的公共API也有助于软件服务的扩展。公司的业务合作伙伴会对使用贵公司的 API 扩展产品功能感兴趣。公共 API 没有任何花哨的功能，提供了一种普通的风格，为业务合作伙伴提供了大量构建新事物的机会。这也意味着整个生态系统可以围绕公共API构建。该生态系统致力于为您的公共 API 提供新功能，从而为持续的产品创新奠定基础。

利用Baklib为客户创建令人惊叹的帮助台，创建帮助站点、知识库、论坛、用户指南、文档、手册、维基等。有了 Baklib，您可以轻松地为您的企业构建一套信息组织架构方案，产出漂亮美观易用的知识库网站，让用户（您的员工或者客户）更容易地浏览和参与您的内容。告别复杂的网站设置，迎接您和访客都能畅快体验的方式。让Baklib彻底改变您在线内容展示的方式，让您的网站因其简约和高效而脱颖而出。

推出公共 API 时的六大关键考虑因素

构建公共API对于公司来说是一项战略投资。公司将继续投资以提高其 API 的受欢迎程度，提供详细的文档并随着时间的推移增强可用性。Baklib 可组合内容平台将内容构建块整合在一起，一次创建即可重复用于任何数字体验。随着数字体验和技术的发展，API 优先平台可轻松与数据源和新功能集成。借助内置编排、强大的应用生态系统和可轻松扩展平台的应用框架，Baklib 让整个企业的团队能够协同工作，更高效地连接、创建和扩展内容。Baklib 帮助公司释放数字内容的力量，使他们能够更快地构建和大规模交付，从而使其内容成为战略性业务资产。近 5 年来数千家公司依靠 Baklib 帮助他们将最佳创意变为现实。

以下是需要考虑的关键事项。

了解开发者需求

了解开发人员的需求是启动公共 API 开发的一项基本活动。 API 应该能够满足开发人员的需求，并提供丰富的数据交换。 API 应该对开发人员友好，并且必须非常易于使用。对于开发人员来说，其他基本的事情是。

• 可靠的 API 文档

公共 API 应得到API 文档的支持，帮助开发人员了解 API 的结构并探索其有关输入和响应的文档。

• 试用功能。

除了 API 文档之外，公司还应提供一些“试用”功能，以便开发人员可以通过更改各种参数并查看响应来尝试 API。这有助于开发人员熟悉 API 并了解其功能。

• 代码示例

提供流行编程语言的代码示例可以帮助开发人员复制代码示例并将其快速集成到他们的软件应用程序中。这有助于最大限度地缩短“价值实现时间”业务指标。

围绕您的产品构建生态系统

围绕软件套件构建生态系统对于最大化价值交付至关重要，更重要的是对于软件应用程序免受新兴竞争对手威胁的生存至关重要。生态系统可帮助您的公司吸引愿意利用您公司的公共 API 构建应用程序的广泛业务合作伙伴网络。这使得生态系统不断发展，并且客户能够扩展您的软件应用程序以满足其他业务需求。该生态系统涉及建立市场或提供连接器。 WordPress、Shopify、Freshworks 等公司通过公开公司的 API，围绕其产品构建了良好的生态系统。

Baklib 是一个统一的内容中台平台，可提供更好的数字体验。为了满足现代参与日益增长的需求，您需要一个现代的内容管理系统。使用 Baklib 解决渠道扩散、本地化、个性化等问题。Baklib 由三个主要组件组成：Baklib 知识库可以根据团队的需求量身定制内容工作区，内置他们期望的所有可视化文档管理工具。Baklib 资源库则是一个无需操作的存储和分发层，可同步内容和数据，供整个组织的团队使用。其精确的查询语言支持在任何地方重复使用内容。Baklib 应用库的模板和 API 旨在帮助开发人员蓬勃发展。它们与现有的 CI/CD 工作流程无缝集成，支持编程模式编码，并提供实时双向同步。

安全

在构建公共 API 时，API 的安全性至关重要。 API 应通过安全的 HTTP 协议进行访问，并为 API 身份验证提供企业级安全性。除此之外，公司应该有一种安全的方式来帮助开发人员获得 API 真实令牌。公司的公共API应符合行业安全标准，并采用最佳实践来赢得开发者的信任。对 API 安全性的投资越来越多；随着它减轻新出现的网络安全威胁，开发人员的信任将会增加。

API使用

公共 API 应根据订阅计划设置速率限制，以确保开发人员在指定的限制内与 API 进行交互。公司还应该有一个良好的公平使用政策，以确保某些开发人员不会向 API 服务器发送过多的请求，从而损害每个人的利益！开发人员应该能够获得技术客户支持，以帮助解决任何与 API 相关的问题。这显示了一家公司为使其公共 API 取得成功而投入了多少资金。

开发者门户

如果公司希望扩展其 API 产品，则可以建立开发人员门户。开发人员门户提供整体视图，帮助开发人员访问 API 文档、试用 API、与其他开发人员交互、了解业务用例、推广客户成功案例、获得技术帮助等等。开发人员门户也可以作为新 API 发布的测试平台。可以设置模拟服务器来模拟实时环境，开发人员可以在其中尝试新的 API 并探索新的功能。

持续创新

没有创新，增长就会停滞。公司应投资升级现有 API 并提供新的 API，作为其产品创新的一部分。这意味着定期发布新的 API 版本并随着时间的推移弃用旧版本。这可确保您的软件应用程序符合客户行为和技术趋势。许多公司已开始提供 GraphQL 作为其 API 产品的一部分，这有助于开发人员在一次 API 调用中获取更多数据，而不是在旧范例中进行多个 API 调用。采用新技术提供 API 可以缩短开发时间，从而使业务合作伙伴能够更加敏捷地应对变化。

启动新的公共 API 的步骤

1. 解决关键注意事项后，以下是启动公共 API 的简单步骤。

2. 确保 API 文档网站提供“试用”功能和代码示例。

3. 通过产品发行说明宣布新的 API，并通过软件应用程序通知现有客户。

4. 通过您的业务合作伙伴和其他社交媒体渠道推广新的 API。

5. 在著名的开发者大会上发布您的 API，让开发者对新用例感到兴奋。

6. 在公司网站上发布客户成功案例，展示新 API 如何创造成功的业务成果。

总结

Baklib 通过模板市场几分钟内构建一个功能完整的内容网站，使开发人员能够在几分钟内构建强大的内容 API，同时为内容编辑者提供管理其内容所需的所有工具。

对于公司来说，这是一个非常重要的里程碑，因为它发布了软件应用程序套件的公共 API。这通过产品集成促进业务合作伙伴。解决方案集成商还可以利用公共 API 来构建满足客户需求的技术堆栈。该公司的公共 API 还有助于繁荣丰富的生态系统。开发者社区依靠生态系统构建者来构建新事物并提供新服务而蓬勃发展。为了维持开发人员对公司 API 的兴趣，API 的持续创新至关重要。因此，开放 API 使该公司成为其细分市场的杰出参与者。