隆重推出全新的 SwaggerHub Apigee 集成

  2017 年 7 月 26 日

随着组织在 API 经济中投入更多,他们越来越意识到确保其 API 项目的成功有多么困难。随着更多设备被添加到多平台生态系统中,以及不同技能水平的消费者开始采用 API,迫切需要制定策略和管理措施以确保项目取得成功。有许多平台,包括基于云的和本地的,允许组织抽象其管理层。来自 Google 的 Apigee 已成为 API 管理领域的领导者之一,拥有一套令人印象深刻的功能以及庞大而忠诚的客户群。随着将 API 设计和文档流程集成到 Apigee 的需求日益增长,SwaggerHub 很荣幸地推出与 Apigee Edge 的直接集成,这是一个用于管理 API 代理的平台。

与 Apigee Edge 无缝集成

SwaggerHub 一直致力于提供最佳的协作式 API 设计和文档解决方案,该解决方案可以完美地融入您的软件生命周期。API 设计和文档直接影响 API 的开发和使用。因此,从最初的设计阶段开始,对 API 进行一流的处理非常重要。但是,我们也认识到客户需要在专门构建用于控制和管理 API 使用的解决方案中管理其 API,并具有速率限制、监控和分析功能。与 Apigee 的直接集成进一步体现了我们致力于确保 SwaggerHub 可以尽可能灵活地与许多软件生命周期工具集成的承诺。这对客户来说意味着他们的 API 设计和文档可以轻松地作为代理导出到 Apigee Edge,最终在不同的开发和生产环境中部署和管理它们。SwaggerHub 是使用 OpenAPI (Swagger) 规范设计和记录 RESTful API 的团队最强大的平台。通过最新的集成,SwaggerHub 现在可以充当您团队 API 设计和文档的单一真实来源,并使它们与 Apigee 强大的 API 管理解决方案保持同步。虽然这个概念很简单,但它对组织的 API 开发生命周期具有强大的影响。该集成可以无缝弥合 API 的开发和使用之间的差距,确保客户在 SwaggerHub 上获得两全其美的体验。

工作原理

该集成使用起来非常简单。您只需准备以下内容即可开始使用:

  1. 一个 SwaggerHub 团队或企业帐户
  2. 一个 Apigee Edge 帐户

您可以在 SwaggerHub 上创建新的 API,也可以转到现有的 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/v2https://myapi.com。如果您的 API 定义指定了 hostbasePathscheme,则为 scheme:host/basePath

就是这样!启用后,每次保存都会触发集成。SwaggerHub 将创建或更新指定的 API 代理,并且从现在开始,每次您保存 API 定义时都会创建代理的新版本。该代理充当现有后端 API 前面的管理层,允许您附加各种策略来管理流量、添加身份验证、转换有效负载等等。在此处阅读 SwaggerHub Apigee Edge 集成的完整文档。

立即试用 Apigee 集成!

我们很高兴将 Apigee 集成添加到我们 现有的各种外部软件工具集成中。如果您是现有的 SwaggerHub 用户,您可以 立即登录以亲自试用。如果您当前正在使用 Apigee 进行 API 管理,但尚未探索 SwaggerHub 进行 API 设计和文档记录,您可以 免费试用 SwaggerHub 14 天有任何意见/问题/反馈?请在下面的评论中告诉我们。