发布概览

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档
信息

发布是将 API 提供给应用开发者使用的过程。

视频:下面的视频简要介绍了 API 发布。

发布 API 涉及以下任务,如以下主题所述:

  1. 在 Edge 上创建捆绑您的 API 的 API 产品。
  2. 在 Edge 上注册应用开发者。
  3. 在 Edge 上注册开发者应用。
  4. 为您的 API 提供文档和社区支持。

任务 1:在 Edge 上创建 API 产品

发布的第一个任务是创建 API 产品。API 产品是一组 API 资源,作为软件包提供给应用开发者使用。使用 Edge Management API 或界面创建 API 产品。(如需详细了解 API 产品,请参阅什么是 API 产品?。)

显示开发者、应用、API 和后端服务的从左到右的序列图。突出显示 API 图标和资源。虚线从开发者指向开发者已构建的应用的图标。从应用出发的箭头和指向应用的箭头表示到 API 图标的请求和响应流,请求上方显示应用密钥。突出显示 API 图标和资源。API 图标下是两组资源路径,分为两个 API 产品:位置产品和媒体产品。位置产品具有 /countries、/cities、/languages 资源,媒体产品具有 /books、/magazines、/movies 资源。API 的右侧是 API 调用的后端资源,包括数据库、企业服务总线、应用服务器和通用后端。

在此图中,API 包含两个产品,每个产品都包含三个 API 资源。

作为 API 提供方,您负责构建 API 和 API 产品,以处理访问权限控制、使用限制以及任何其他业务要求。例如,您可以:

  • 发布允许对 API 资源具有只读权限的免费 API 产品。
  • 以较低的价格发布第二个 API 产品,具有与免费版本相同的 API 资源的读写权限,但具有低访问限制,例如每天 1000 个请求。
  • 以更高的价格发布第三个 API 产品,具有同一 API 资源的读写权限,但具有较高的访问限制。

请务必注意,Edge 让您可以灵活地创建符合 API 业务要求的 API 产品。

如需详细了解如何创建 API 产品,请参阅创建 API 产品

任务 2:在 Edge 上注册应用开发者

开发者创建使用您的 API 的应用。应用开发者在 Apigee Edge 中注册后,才能注册其应用。他们注册应用时,会收到一个 API 密钥,该密钥将授予应用对 API 的访问权限。

通过应用注册流程,您可以控制哪些用户可以访问您的 API。您可以随时删除应用开发者,此操作会使该开发者关联的所有 API 密钥都失效,从而拒绝该开发者访问您的 API。

显示开发者、应用、API 和后端服务的从左到右的序列图。突出显示开发者图标。虚线从突出显示的开发者指向开发者已构建的应用的图标。从应用出发的箭头和指向应用的箭头表示到 API 图标的请求和响应流,请求上方显示应用密钥。API 图标下是两组资源路径,分为两个 API 产品:位置产品和媒体产品。位置产品具有 /countries、/cities、/languages 资源,媒体产品具有 /books、/magazines、/movies 资源。API 的右侧是 API 调用的后端资源,包括数据库、企业服务总线、应用服务器和通用后端。

作为 API 提供方,您可以决定如何注册开发者。例如,您可以使用手动注册流程,这要求潜在开发者联系您的组织进行注册。潜在开发者必须提供所有必要的信息,例如电子邮件地址、名字和姓氏以及公司名称。如果您批准开发者的请求,可以使用边缘管理界面手动注册开发者。如需了解详情,请参阅管理应用开发者

此外,Apigee 还提供了可用于自动执行开发者注册流程的工具。 例如:

  • 使用 Apigee Edge Management API 将注册功能集成到您的现有网站中。Edge Management API 是一个 REST API,可用于执行开发者注册流程的所有方面。如需了解详情,请参阅使用 Edge Management API 发布 API
  • 使用 Apigee Developer Services 门户注册开发者。该门户不仅内置了对开发者注册的支持,而且还有许多其他功能来支持您的 API。如需了解详情,请参阅什么是开发者门户?

任务 3:在 Edge 上注册开发者应用

您必须先在 Edge 上注册应用,然后才能访问您的 API。但是,只有已注册的开发者才能在 Edge 上注册应用。

显示开发者、应用、API 和后端服务的从左到右的序列图。突出显示应用、请求/响应和 API 密钥箭头。虚线从开发者指向开发者已构建的应用的图标。从应用出发的箭头和指向应用的箭头表示到 API 图标的请求和响应流,请求上方显示应用密钥。突出显示 API 图标和资源。API 图标下是两组资源路径,分为两个 API 产品:位置产品和媒体产品。位置产品具有 /countries、/cities、/languages 资源,媒体产品具有 /books、/magazines、/movies 资源。API 的右侧是 API 调用的后端资源,包括数据库、企业服务总线、应用服务器和通用后端。

在注册应用时,开发者可选择一个或多个 API 产品。例如,您可以发布与不同类型的服务和价格方案对应的多个 API 产品。之后。应用开发者接着可以从可用 API 产品列表中选择和选取。

为了响应在 Edge 上注册应用,Edge 会向应用分配一个唯一的 API 密钥。应用必须将该 API 密钥作为每次请求向 API 资源传递的一部分。该密钥已经过身份验证,如果有效,则会授予请求。作为服务提供商,您可以随时撤消密钥,以使该应用无法再访问您的 API。

作为 API 提供方,您可以决定要如何注册应用。您可以执行以下操作:

  • 使用要求开发者联系您的组织以注册其应用的手动流程。作为响应,您可通过电子邮件向开发者发送 API 密钥。
  • 使用 Edge Management API 将应用注册功能和密钥分发集成到您的网站中。
  • 对于付费 Edge 帐号,请使用 Apigee Developer Services 门户,该门户内置了对应用注册和 API 密钥分发的支持。

如需了解详情,请参阅注册应用和管理 API 密钥

任务 4:记录您的 API

发布 API 产品的一项重要考虑因素是提供文档和开发者反馈机制。具有社交发布功能的开发者门户正日益用于与开发社区进行通信。这包括传达静态内容(例如 API 文档、使用条款),以及社区贡献的动态内容(如博客和论坛),以及客户支持功能。

显示开发者、应用、API 和后端服务的从左到右的序列图。突出显示开发者图标。开发者下方有一个框,表示开发者门户。门户包含 API 文档、示例、教程、API 参考等。门户网站还包含博客、论坛和支持门户。虚线从突出显示的开发者指向开发者已构建的应用的图标。从应用出发的箭头和指向应用的箭头表示到 API 图标的请求和响应流,请求上方显示应用密钥。API 图标下是两组资源路径,分为两个 API 产品:位置产品和媒体产品。位置产品具有 /countries、/cities、/languages 资源,媒体产品具有 /books、/magazines、/movies 资源。API 的右侧是 API 调用的后端资源,包括数据库、企业服务总线、应用服务器和通用后端。

您可以构建自己的网站来部署文档;如果您有付费 Edge 帐号,则可以使用 Apigee 开发者服务门户。该门户内置了对文档、博客、论坛和支持开发者社区所需的其他类型的内容的支持。

借助 SmartDocs,您可以采用让 API 文档完全互动的形式在开发者服务门户上记录您的 API。借助 SmartDocs 的互动式文档,门户用户可以:

  • 了解 API
  • 向 API 发送实时请求
  • 查看从 API 返回的实时响应

例如,下图显示了使用 SmartDocs 在门户上记录的 API。此 API 提供特定位置的天气信息:

SmartDocs API 方法主题,可让您通过点击主题中的按钮来调用 weather API。

开发者为“w”查询参数输入一个值以指定位置,然后点击 Send the request 按钮以查看实时请求和响应。通过创建有关 API 的交互式文档,门户用户能够轻松学习、测试和评估您的 API。

Edge Management API 是一个 REST API,让您可以使用任何 HTTP 客户端访问 API 服务。Apigee 使用 SmartDocs 为 Edge Management API 创建交互式文档。 请点击此处查看该 API 文档。

如需了解详情,请参阅使用 SmartDocs 为 API 提供文档