API 市场关键要点
各个行业的公司正在寻找通过外部 API 扩展服务来塑造数字业务的方法。然而，要获得 API 的真正好处，是需要超越基本的 API 管理，再到创建 API 市场，这是一种专注于连接生产者和消费者的专用平台业务模型。随着越来越多的公司寻求商业平台以获得竞争优势，API 市场将平台业务模型的优势带给了 API 管理。
- API 市场通常都会包括以下几个部分：在典型的场景中，生产者首先发布 API，然后通过 API 开发平台对这些 API 进行编辑和测试运行。
- API 管理系统为任何 API 市场提供一个完整的规范标准并使其能够有效运行。
- 第一个部分是使用有效的 API 开发平台。在 API 市场中，API 开发平台必须提供直观的体验。
- 除了使用 API 开发平台之外，企业还需要在市场中引入促进 API 重用的激励措施，继续推动 API 变现货币化。
- 在管理 API 市场时，企业需要保持对谁可以发布内容和进度的控制，并确保根据既定的规范和标准（如 URL 模式，命名约定和访问控制规则）发布合符要求的 API。
因此，API 市场通常不仅涉及开发平台和 API 管理的其他技术方面，还涉及确保 API 实现其目标的业务和人员方面，尤其是促进 API 的消费和使用。在以下部分中，我们将探讨在 API 生态系统中发挥作用的技术和业务考虑因素，并讨论创建和管理有效 API 市场的关键步骤。
API 管理支持 API 市场
API 市场通常都会包括以下几个部分；在典型的场景中，生产者首先发布 API，然后通过 API 开发平台对这些 API 进行编辑和测试运行。使用者可以直接来到发布平台，以查找，发现和探索 API，也可以测试、调用监控这些 API。API 市场的这部分是如何交互的情况如图 1 所示。
图 1：API 市场的关键组成
API 管理系统为任何 API 市场提供一个完整的规范标准并使其能够有效运行。它通常由五个核心组件组成：
- API 网关用作 API 运行时和策略执行点，强制执行限制，速率限制和安全策略。
- API 安全性可以由网关或通过集成的身份和访问管理（IAM）基础解决方案提供。
- API 开发平台充当目录，为应用程序开发人员提供编辑，监控和测试 API 的集中位置。
- PI 开发平台提供了从后端服务设计 API 的功能。
- API 分析提供 API 使用的快照和 API 货币化的 Feed 数据。
成功实施市场需要采用更先进的方法来实现 API 管理系统的某些方面，尤其是 API 开发平台和分析。下面我们将研究构建强大 API 市场的五个基本要素，以促进使用 API 构建一个吸引更多人参与业务，增加收入流和提高忠诚度的应用程序。
API 独立发布平台
第一个部分是使用有效的 API 独立发布平台。在 API 市场中，API 开发平台必须提供直观的体验，以支持企业开发人员方便编辑 – 无论是专业软件开发人员，业务高级用户还是长尾开发人员。API 提供商可以选择在平台上受保护的注册页面后面托管所有资源和文档，或者通过向公众开放来提高透明度。使用者可以直接来到发布平台，以查找，发现和探索 API，也可以测试和调用特定的 API。
一个很好的例子就是我们这个大型电信服务提供商的客户，它构建了一个 API 驱动的应用程序 / 服务创建生态系统，它可以快速，轻松地创建运行在其上的数字，OTT（over-the-top）服务。依靠公司的移动通信平台，为开发人员和非开发人员提供的独立平台，为用户提供了直观的体验，可以在几分钟内查看条款和条件，注册并开始使用电信服务。
专业和平台开发人员为该平台创建的服务将在电信公司的应用商店中发布。量身定制的平台开发策略使企业能够提供来自各种开发商的应用程序，从初创企业到企业，政府机构，小型零售企业，学校，教堂和慈善机构内的非开发人员。仅在前 18 个月，就有超过 2,500 名应用创建者根据电信业务的 API 发布了 3,300 多种应用和服务。
在典型的 API 管理环境中，组织的 API 所有者发布一组 API，然后由应用程序开发人员使用。然而，为了使这个概念真正可持续，应用程序开发人员需要对发布的 API 的形式和类型有发言权。这可能包括将字段添加到 API 的请求，以及将许多不同的 API 混合到新的 API 以适应特定设备的约束和要求。实现这一目标的最简单方法是建立跟踪功能请求的论坛或票务系统，并促进 API 的消费者和生产者之间的通信。更具前瞻性的方法是 API 开发平台本身允许消费者使用自助式沙盒平台来混搭 API 并创建自己的私有 API。后者为消费者提供了一个完美的平台，可以创建自己的私有 API，满足应用程序的独特需求，同时维护提供商发布的官方 API。
促进再利用的激励措施
除了创建门户之外，企业还需要在市场中引入促进 API 重用的激励措施，继续推动 API 变现货币化。值得注意的是，在组织内，激励措施通常没有货币价值，带来的是其他的价值。例如，公司可能会维护一个排行榜，以突出顶级 API 发布者和应用程序开发人员，让更多人愿意使用 API。
企业还可以跟踪哪些 API 拥有最多订户，并在开发平台上的仪表板上显示它们。允许开发人员学习和应用技能的研讨会和黑客马拉松也可以作为激励措施。在寻求向外部各方提供激励时，组织往往会采用某种形式的财务激励措施。例如，前面讨论的电信服务提供商允许用户使用预定义的模板快速创建应用程序，然后使他们能够共享从他们在公司的应用商店发布的应用程序生成的收入。
每项服务的收益分享模型对于服务的第三方创建者为 70%，对于电信公司为 30%。这使得该公司实现了使用其 API 构建的应用程序所带来的收入环比增长 20%。
API 货币化
API 正迅速成为销售或提供给应用程序开发人员的产品，从其他业务部门或使用它们的第三方组织获得收入。因此，API 市场需要直接或间接货币化 API 的机制。通过间接货币化，公司认识到更广泛地使用 API 可以为其核心业务带来更多客户和交易，并扩展生态系统。一个很好的例子是 StubHub，它是活动门票的主要卖家。其 API 计划的目标是使旅游公司，酒店和其他酒店业的生态系统能够向其客户追加活动门票。只要酒店客户使用酒店网站上的 StubHub API，StubHub 就能赚钱。
同时，组织可能希望采用两种类型的直接货币化。通过直接内部货币化，一个部门通常会回拨另一个部门以使用特定的 API。由于资金是通过公司会计在内部分配的，因此没有实际的信用卡收费或电汇。在外部直接货币化方案中，企业销售服务，客户是外部业务，其解决方案由 API 提供。例如，Twilio 销售的 API 可让 Uber 在 Uber 的移动应用程序中提供短信和电话。
总体管理
在管理 API 市场时，企业需要保持对谁可以发布内容和位置的控制，并确保根据组织标准（如 URL 模式，命名约定和访问控制规则）发布正确的 API。为此，他们需要确保包含有助于满足战略和合规要求的总体治理模型。
可以通过在集中式 API 开发平台中发布 API 来集中管理 API。但为了避免扼杀创造力，企业可能希望考虑采用自下而上的治理策略而不是自上而下的方法。例如，企业可以选择分散的 API 发布模型，使每个业务部门在设计和发布 API 时具有自主权。
虽然主要目标是将结构应用于 API 的管理，但自下而上的方法通过使每个业务功能能够独立管理其各自的 API（包括对这些已发布的 API 的更新或设计增强）来满足此要求。通过简化此任务，每个业务部门都可以在团队成员构建和公开 API 的过程中发挥创造性，同时确保对其进行有效管理。
如何管理 API 以及如何利用 API 进行开发、测试、发布、监控等一系列研发管理，一直是很多企业面临的问题，国内也有部分 API 管理平台，但最推荐的是 EOLINEKR，因为能读取通过 Github、Gitlab、码云等代码仓库来读取代码的注解并自动生成 API 文档，支持 Java、PHP 两种语言，和完善的自动化测试管理，能够完成利用 API 进行从研发测试到网关监控，再到发布运行等一系列流程的研发管理解决方案。有兴趣了解，官网：https://www.eolinker.com
API 分析
如前所述，分析在支持 API 货币化方面发挥着重要作用。更广泛地说，API 分析使企业能够深入了解性能，可用性和潜在安全问题的最新问题，以及随着时间的推移分析以支持决策。企业通常最熟悉批量分析，可以将其用于识别随时间发布的 API 的长期趋势。其中一些趋势包括错误的调用，延迟时间，跨地理位置的一般使用，随时间的注册，限制请求，异常响应警报和 API 健康可用性警报。
值得注意的是，通过机器学习进行的预测分析可以应用于实时和历史（批量）数据的组合，以识别诸如潜在欺诈，用户速率限制，即将发生的容量限制或其他因素等问题，以便及时做出应对。
最后，仪表板使业务和 IT 用户能够以有意义的方式可视化流式和批量分析的趋势，以深入了解可用数据。通过仪表板，企业可以跟踪一组常见趋势，然后根据需要指定不同的警报。例如，企业可能希望跟踪每个应用程序的 API 的一般用法，每个应用程序进行最多 API 调用的顶级用户，以及每个应用程序 API 使用的资源路径。
组织可能还希望使用仪表板来监控每个应用程序的错误 API 调用的数量。例如，在错误调用中，消息通过故障序列进行调解，并且默认情况下，API 管理系统会在后端服务不可用时将 API 调用视为错误。其他示例仪表板包括 API 延迟时间，跨地理位置的 API 使用，随时间推移的开发人员注册以及异常响应时间警报。
与任何企业一样，成功取决于所有利益相关者的贡献和参与，通过整合这里讨论的技术和策略，企业将能够很好地利用其当前的 API 管理计划来创建 API 市场，从而推动扩张，创造新的商机并创造新的收入来源。
原标题：Key Steps to Building and Managing an Effective API Marketplace
作者：Mifan Careem，WSO2 解决方案架构的高级主管
翻译和修改：隔壁王书
原文地址：https://www.infoq.com/article…
配图来源：www.softwaretestingmaterial.com 等