API即产品 - 什么是API即产品？

应用程序编程接口 (API) 已成为现代软件开发的构建块。它们使开发人员能够通过为不同的系统和设备之间交互提供标准化的方式来创建强大的应用程序组合，并且它们允许组织利用其现有的功能和数据来创建无缝集成。

API使个人开发人员以及公司能够定义新的业务模型并创造新的收入来源。对于那些开始向外部用户提供 API 的企业来说，转向 API 即产品模型可以放大 API 和 API经济提供的所有优势。

API 作为产品意味着什么

当我们谈论 API 作为产品时，我们指的是将 API 视为独立产品而不仅仅是支持技术的过程。这意味着 API 的设计、开发和营销与公司的任何其他产品一样。 API 即产品的概念不仅仅是将 API 的访问权限扩展到组织外部的开发人员，这是组织思考 API 以及如何使用 API 来推动业务价值方式的转变。

将 API 作为产品对待的好处

将 API 视为产品将使公司受益，不仅可以通过API 货币化提供更多收入机会，而且可以作为整体改进 API 和 API 计划的一种方式。您可以看到 API 在推动业务成功方面的重要性，像 Salesforce 这样的公司有 50% 的交易是通过 API 执行的，而 eBay 60% 的列表是通过 API完成的。

API 可以打包并作为服务出售给开发人员。付费访问、高级功能、增值服务和合作伙伴关系都是企业通过 API 获利的方式。如果一家公司将其API视为产品，则可以提高其软件的整体质量。例如，它迫使组织优先考虑安全性和可靠性等方面。此外，公司必须实施更强有力的质量保证流程并确保服务质量。

是什么使 API 成为产品？

“API 作为产品”意味着将您的 API 从概念化到持续管理视为产品，并将包括实施以用户为中心的设计原则、创建更好的文档以及维护牢固的客户关系。

满足目标受众的需求

API 即产品方法意味着 API 旨在满足目标受众的需求，它的功能和价值主张都必须明确。

为了实现这一目标，API 即产品必须采用以用户为中心的方法进行设计，并专注于提供一致且直观的体验。这意味着收集新用户或现有用户的反馈，以迭代设计并进行改进。用户故事应该以 API 的开发者和消费者为中心来创建和集中。

通过全面的文档支持您的 API

全面的文档是 API 即产品的一个关键功能。好的 API 文档将包括指南和参考文档，整个文档集应通过交叉引用、标记和直观分类来促进可发现性。

“快速入门”指南应该让开发人员尽快使用 API 实现相当于“hello world”的操作，并尽可能减少障碍。概念性概述将向开发人员介绍问题域，并解释如何使用实体对其进行建模。使用开发人员门户启动演练将讨论如何通过 API 调用和代码示例来执行特定用例。此类指南不仅对将要实施 API 的工程师有用，而且还可以作为试图确定您的 API 是否能满足其需求的管理人员和业务分析师的小册子。

全面的文档对于提供完整记录所有端点、输入参数、API 密钥和响应（包括潜在错误）的参考也至关重要。理想情况下，此参考将是交互式的，并带有教程，允许开发人员尝试 API 并立即看到结果。

与消费者保持关系

当您的产品是 API 时，您的主要消费者是开发人员。与任何产品一样，您需要适当的反馈机制来帮助维护客户关系。

对于开发人员来说，这意味着为他们提供识别和跟踪错误的工具，使他们能够在确定改进优先级方面发挥作用，并使他们能够提出对文档的编辑建议。潜在开发人员评估您的 API 的部分原因是其支持的活跃程度 – 如果错误没有得到解决或者他们无法获得问题帮助，他们可能会觉得该产品没有得到维护。与消费者举办网络研讨会也是建立和维持这些关系的好方法。

将您的 API 作为产品进行管理

如果 API 是一种产品，则其生命周期必须由 API 产品经理和负责其成功和持续改进的专门团队进行管理。

您的 API 产品经理和开发团队需要优先考虑策略细节，例如版本控制、弃用以及持续支持和维护的方法。 API 应该有自己的发布周期、QA 流程和问题跟踪。API 中心将有助于简化这些 API 管理流程。

使 API 取得成功

当公司转向 API 产品化时，它会希望确保 API 资源的投资是合理的，并且 API 会得到广泛采用。使典型消费产品成功的许多相同因素也适用于 API，从提供良好的客户体验到持续的内部开发，再到选择正确的业务模式。

打造出色的开发者体验

对于一个成功的 API 产品，就像任何成功的产品一样，API 即产品必须唤起积极的消费者体验。由于开发人员是您的主要消费者，您必须考虑他们如何体验 API。

除了具有上述质量的文档之外，您的 API 还应该易于使用。它应该遵循共同的惯例并且进入门槛较低。开发人员发现它越容易理解和使用，他们就越有可能采用它。

但是，如果 API 由于复杂性、返回值或约定不一致或由于功能限制而难以使用，开发人员可能会寻找其他选项。不提供开发人员使用层并且难以对新用户进行身份验证将阻止临时开发人员进行探索性编码。

软件开发工具包 (SDK) 和沙箱环境的可用性还可以为开发人员提供一种快速开始使用他们选择的编程语言进行编写并与实际数据交互的机制，从而使开发人员体验更加积极。如果无法提供工作沙箱环境，请尝试简化为开发人员配置环境的过程，并编写脚本来设置允许最终用户完成常见 API 任务的最小实体集。

保证性能和质量

可扩展性、可靠性和安全性也是成功的 API 即产品的关键特征。

随着用户和请求数量的增长，API 必须能够处理不断增加的流量负载。这需要仔细设计 API 架构，包括使用缓存、负载平衡和其他技术，以确保您的用户不会遇到性能下降的情况。

停机或中断可能会产生严重后果，包括收入损失和用户信心下降。支持 API 生态系统的系统必须采用冗余、故障转移机制和其他措施来最大限度地降低服务中断的风险。

安全漏洞可能导致数据泄露、欺诈和其他类型的网络攻击，从而产生重大的财务和声誉影响。为了确保安全，API 的设计必须具有强大的身份验证、加密和访问控制机制，以及定期的安全审核和测试。

让您的 API 变得灵活

您的 API 越灵活，集成和采用的可能性就越大。

API 的灵活性可以采取多种形式，例如提供一系列端点、选项和参数，允许用户自定义与 API 的交互。构建灵活的 API 意味着查询和操作的实现不会受到太多限制。您还需要包括过滤器、排序和分页选项等功能，允许用户检索满足其要求的特定数据子集。

推动社区参与

社区参与可以培养用户之间的协作感和主人翁意识，反过来，当他们成为您的技术的倡导者时，也会促进采用。

社区参与涉及围绕 API 建立开发人员和用户社区，他们可以在其中相互分享想法、提出问题并提供反馈。通过与社区互动，您的 API 产品经理和团队可以深入了解用户的需求和偏好，确定需要改进的领域，并建立忠实的用户群。社区参与还可以提高 API 的可见性和采用率，从而增加使用量和收入。

此外，随着用户对其持续的开发和增长进行投资，强大的社区可以帮助确保 API 的长期成功。

选择正确的商业模式

您选择的业务模式将决定 API 如何产生收入并确保您的长期成功。您可能想要使用免费增值、订阅、即用即付或市场模式。

为 API 产品选择正确的业务模型取决于目标受众、竞争格局以及 API 的特性和功能等因素。正确的商业模式有助于推动采用和收入，而错误的模式可能会导致错失机会。

如何实现 API 产品化

将现有 API 转化为产品可能会带来一些挑战。

挑战之一是不完整性，即 API 缺乏足够的支持端点，从而阻止 API 的使用者完成用户旅程。参数、返回值或错误条件也可能不清楚、不一致或包含“错误”。对于初创公司来说，这种情况很容易发生，因为它们可能已经构建了特定功能来适应重要客户，而没有考虑它们如何适应更大的综合环境。

此外，过时或缺失定义等文档问题也可能是一个挑战。安全性和可扩展性可能没有被优先考虑，组织可能会发现它还没有准备好提供必要水平的技术支持。

转变为 API 产品思维

为了成功地将 API 产品化，企业必须从将 API 作为项目转变为产品。这意味着将开发人员视为消费者，而不仅仅是构建者，并定义 API 的功能和价值及其需求。此外，实践“API 优先”开发也很重要，这涉及专注于清晰的 API 设计并在了解其预期用例的情况下开发 API。

采用产品思维进行 API 开发可以帮助组织将其 API 策略与业务目标保持一致，推动创新和协作，并改善整体开发人员体验。

为您的 API 提供资源

为了成功地将 API 产品化，企业必须配备适当的人员和基础设施。

在人员方面为组织提供资源的一部分涉及选择最适合其需求的组织结构，例如单一团队所有权或横向跨组织结构。它还意味着填补关键角色，例如负责产品策略、路线图和 API 定义的产品经理，拥有与开发人员合作的技术专业知识的支持人员，以及能够与开发人员社区互动并推广 API 的技术布道者。

企业还需要构建基础设施来支持其 API，例如监控工具和 API 中心，以帮助管理和跟踪 API 的性能。随着 API 使用量的增长，基础设施必须能够通过负载平衡和弹性扩展等技术来处理增加的流量和请求。这可能涉及利用 API 网关，它充当 API 的前门并提供路由、安全性和速率限制等功能。

制定推出计划

全面的计划应包括沟通策略，概述如何以及何时向开发人员和利益相关者引入 API。产品经理应该定义一个产品路线图，概述 API 的开发里程碑和后续功能发布。该计划应确定为最小可行产品 (MVP) 提供的初始 API 集，并确定随着时间的推移将添加的后续特性和功能。

通过创建明确的推出计划，企业可以确保其 API 有效启动，并且开发人员和利益相关者可以清楚地了解 API 的价值主张和未来发展。

评估和维护您的 API

评估和维护 API 即产品对于其长期成功至关重要。

使用指标来了解 API 的使用方式、其性能及其对业务的影响非常重要。 API 调用数量、活跃用户数量和响应时间等指标可帮助 API 管理和 API 开发团队深入了解 API 的使用方式及其执行情况。

正如我们所讨论的，提供支持并征求开发人员的反馈对于识别问题和意外行为以及改善整体用户体验至关重要。这意味着创造与开发人员互动的机会，例如在论坛上发帖或出席会议，您可以在其中围绕 API 建立社区并帮助识别新产品用例。

根据市场需求和业务战略确定新 API 并确定其优先级也很重要。应计划和传达定期更新，以使开发人员了解情况并参与其中，并确保 API 继续满足不断变化的需求。通过遵循这些最佳实践，API 可以对开发人员和企业保持相关性、有用性和价值。

释放 API 的全部潜力

将 API 视为独立产品可以释放新的价值和收入机会。
完全产品化的 API 将确保满足使用 API 的开发人员的需求，从而推动更广泛的采用。必须采用这种方法来充分发挥 API 的潜力并在当今快节奏的技术领域保持领先地位。