你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

什么是 Azure API 中心?

Azure API 中心支持在一个集中位置跟踪所有 API,以便进行发现、重用和治理。 使用 API 中心开发和维护组织 API 的结构化有序清单(无论其类型、生命周期阶段或部署位置如何),以及相关信息,例如版本详细信息、API 定义文件和通用元数据。

借助 API 中心,整个组织的利益干系人(包括 API 计划经理、IT 管理员、应用程序开发人员和 API 开发人员)可以发现、重用和治理 API。

注意

Azure API 中心是一个设计时 API 治理和集中式 API 发现解决方案。 Azure 还提供诸如 Azure API 管理等补充服务,这是一种使用 API 网关进行运行时 API 治理和可观测性的解决方案。 详细了解 Azure API 中心和 API 管理的差异以及它们如何协同工作。

好处

  • 创建和维护组织清单 - 组织可生成一个在其组织中可用的完整的 API 清单。 注册所有 API 管理解决方案中管理的 API,包括 Azure API 管理和来自其他提供商的平台。 还包括非托管 API 和正在开发的 API。 促进通信,让 API 计划经理和开发人员协作以提高 API 重用、质量、安全性、合规性和开发人员工作效率。

  • 管理组织的 API - 通过更全面地了解组织内生成的和使用 API,API 项目经理和 IT 管理员可以管理此清单, 通过定义自定义元数据分析 API 定义,以强制实施 API 样式准则的符合性,从而确保其符合组织标准。

  • 简单的 API 发现 - 组织希望促进 API 重用,以最大限度地提高开发人员的工作效率,并确保开发人员使用正确的 API。 Azure API 中心可帮助计划经理和开发人员使用内置和自定义元数据发现 API 清单和筛选器。 ​

  • 加速 API 使用 - 在使用 API 时最大程度地提高开发人员工作效率,并确保它们以与组织标准一致的安全方式使用。

关键功能

针对以下任务创建和使用 API 中心:

  • API 清单管理 - API 开发人员和 API 项目经理可使用 Azure 门户、Azure CLI、开发人员工具(例如 CI/CD 管道)以及指向 API 源(例如 Azure API 管理服务)的链接来注册组织的所有 API,以将其纳入集中清单。

  • API 设计和开发 - 借助适用于 Visual Studio Code 的 Azure API 中心扩展,开发人员可以直接从创建 API 和应用的相同开发环境中注册 API。 开发人员可利用扩展与 GitHub Copilot 和适用于 Azure 的 GitHub Copilot 的集成,根据代码或自然语言说明创建 API 定义。

  • 实际 API 表示形式 - 添加有关每个 API 的真实信息,包括版本和定义(如 OpenAPI 定义)。 列出 API 部署并将其与运行时环境相关联,例如表示 Azure API 管理或其他 API 管理解决方案。

  • API 治理 - 使用内置和自定义元数据来组织和筛选 API 和相关资源,以帮助 API 使用者实现 API 治理和发现。 设置 Lint 分析和分析以强制实施 API 定义质量。

    API 开发人员可以通过集成 Lint 分析支持和中断性变更检测,对 Visual Studio Code 进行左移 API 设计一致性检查。 与 Dev Proxy 等工具集成,确保应用不会使用未注册的影子 API 或不符合组织标准的 API。

  • API 发现和重用 - 使企业开发人员和 API 项目经理能够通过 API 中心门户或通过 Azure API 中心 Visual Studio Code 扩展访问的 API 平台目录发现 API。

若要详细了解可在 Azure API 中心管理和功能中的实体,请参阅关键概念

可用区域

Azure API 中心当前在以下 Azure 区域中可用:

  • 澳大利亚东部
  • 印度中部
  • 美国东部
  • 英国南部
  • 西欧

免费计划和标准计划提供 API 中心。 了解详细信息

Azure API 中心和 API 生态系统

Azure API 中心可在组织的 API 生态系统中扮演关键角色。 考虑假设的 Contoso 组织,它采用了 API 优先的策略,强调 API 在其软件开发和集成中的重要性。

Contoso 的 API 开发人员、应用开发人员、API 计划经理和 API 管理员通过 Azure API 中心进行协作,以开发和使用组织的 API 清单。 请参阅下图和说明。

显示示例 API 生态系统中的 API 中心的示意图。

Contoso 的 API 生态系统包括以下内容:

  • API 开发 - Contoso 的开发人员定期生成 ASP.NET Web API。 他们还使用 HTTP 触发器创建 Azure Functions。

  • API 部署环境 - Contoso 将其一部分 API 部署到 Azure 应用服务。 另一部分 API 部署到 Azure 函数应用。

  • Azure API 管理 - Contoso 使用 Azure API 管理来管理、发布和保护其 API。 他们使用单独的实例进行开发、测试和生产,每个实例都有不同的名称。

  • Azure API 中心 - Contoso 已采用 Azure API 中心作为其集中式 API 发现、治理和使用中心。 API 中心充当结构化有序的 API 中心,提供有关所有组织 API 的综合信息,维护包括版本和相关部署在内的相关信息。

后续步骤