随着组织在 API 经济中投入更多，他们越来越意识到确保 API 项目成功可能有多么困难。随着越来越多的设备加入多平台生态系统，以及不同技能水平的消费者开始采用 API，明确需要政策和管理来确保项目取得成功。有许多平台，包括基于云的和本地的，允许组织抽象其管理层。Apigee（来自 Google）已成为 API 管理领域的领先者之一，拥有令人印象深刻的功能套件以及庞大而忠诚的客户群。随着将 API 设计和文档流程集成到 Apigee 的需求日益增长，SwaggerHub 很荣幸推出与 Apigee Edge（一个用于管理 API 代理的平台）的直接集成。
无缝集成至 Apigee Edge
SwaggerHub 始终致力于提供最佳的协作式 API 设计和文档解决方案，使其能够完美融入您的软件生命周期。API 设计和文档直接影响您的 API 的开发和使用。因此，从最初的设计阶段就开始对您的 API 进行一流的对待非常重要。但我们也认识到客户需要在一个旨在控制和管理 API 使用（包括速率限制、监控和分析功能）的解决方案中管理其 API。与 Apigee 的直接集成进一步巩固了我们确保 SwaggerHub 能够灵活地与尽可能多的软件生命周期工具集成的承诺。这对客户意味着，他们的 API 设计和文档可以轻松地导出到 Apigee Edge 作为代理，最终在不同的开发和生产环境中进行部署和管理。对于使用 OpenAPI (Swagger) 规范设计和文档化其 RESTful API 的团队来说，SwaggerHub 是最强大的平台。通过这项最新集成，SwaggerHub 现在可以作为您团队 API 设计和文档的单一真相来源，并使其与 Apigee 强大的 API 管理解决方案保持同步。虽然这个概念很简单，但它对组织的 API 开发生命周期具有强大的影响。这项集成可以无缝弥合 API 开发和使用之间的鸿沟，确保客户在 SwaggerHub 上获得两全其美的体验。
工作原理
该集成使用起来非常简单。您只需具备以下条件即可开始使用：
- 一个 SwaggerHub 团队版或企业版账户
- 一个 Apigee Edge 账户
您可以创建一个新 API，或在 SwaggerHub 上访问现有 API。集成可以在 SwaggerHub 编辑器的右上角找到，您可以在下拉菜单中选择 Apigee Edge 集成。
然后您可以添加您的 Apigee 授权，并配置几个快速字段以设置集成。这些字段包括：
- 名称： 此集成的显示名称，例如， Apigee。
- Apigee Edge 服务器： 用于访问 Edge 管理 API 的 URL。如果您使用 Apigee Edge Cloud（SaaS 版本），请保留默认值 https://api.enterprise.apigee.com/v1，否则，请将其替换为您的 Edge 实例对应的 URL。
- Apigee 电子邮件 和 Apigee 账户密码： 您用于登录 Apigee Edge 的电子邮件和密码。
- 组织： 您的 Edge 账户中将创建 API 代理的组织。您可以在 Apigee Edge 中的用户名菜单中查看您的组织名称。
- API 名称： 创建的 API 代理的唯一名称。有效字符包括字母、数字、破折号 (-) 和下划线 (_)。您还可以指定现有 API 代理的名称 - 在这种情况下，集成将创建该代理的新修订版。代理名称也将保存在您的 API 定义中的 x-apigee-id 键中。
- 目标 URL – Apigee Edge 将路由请求到的端点。例如， http://api.example.com/reports/v2 或 https://myapi.com。如果您的 API 定义指定了 host、 basePath 和 scheme，则为 scheme:host/basePath。
就是这样！该集成一旦启用，每次保存时都可以触发。SwaggerHub 将创建或更新指定的 API 代理，从现在起，每次您保存 API 定义时，都会创建该代理的新修订版。代理作为您现有后端 API 前面的管理层，允许您附加各种策略来管理流量、添加身份验证、转换有效负载等。在此处阅读 SwaggerHub Apigee Edge 集成的完整文档。
立即试用 Apigee 集成！
我们很高兴将 Apigee 集成引入我们现有的一系列与各种外部软件工具的集成。如果您是 SwaggerHub 的现有用户，您可以立即登录亲自试用。如果您目前正在使用 Apigee 进行 API 管理，但尚未探索 SwaggerHub 用于 API 设计和文档，您可以免费试用 SwaggerHub 14 天。有任何评论/问题/反馈？请在下面的评论中告诉我们。