了解 API 和 API 代理

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

Apigee Edge 可以帮助您轻松快速地构建可供应用开发者使用的 RESTful API。您可以通过构建 API 代理作为后端服务的代管式“表层”在 Edge 上公开 API。本主题讨论了 Apigee Edge 上的 API 和 API 代理之间的关系。

视频:观看此视频短片,了解 API 代理。

什么是 API?

API 是可以让应用轻松“使用”来自其他应用的功能或数据的接口。通过定义稳定且简化的应用逻辑和数据入口点,API 可让开发者轻松访问和重复使用其他开发者构建的应用逻辑。对于“Web API”,这些逻辑和数据会通过网络公开。

由于使用 API 的应用对更改很敏感,因此 API 还暗含一则“合同”。此合同提供一定程度的保证,即随着时间的推移,API 会以可预测的方式发生变化。

借助 Apigee Edge,您可以构建 API。如果您已经有 API,则可以直接公开它们,同时增加管理和可见性层。如果您有启用了 HTTP 的服务(例如基于 SOA 的 Web 服务),也可以通过 Apigee Edge 将它们公开为 API。

此外,Edge 还能让您通过实现托管在 API 服务平台上的应用来构建 API,而无需任何后端服务。您可以使用 JavaScript、Java 和 Node.js 构建这些应用。

什么是 API 代理?

您可以通过实现 API 代理在 Apigee Edge 上公开 API。API 代理将面向应用的 API 与后端服务分离,从而保护这些应用免受后端代码更改的影响。当您对服务进行后端更改时,应用会继续调用相同的 API,而不会中断。

API 代理配置中有两种类型的端点:

  • ProxyEndpoint:定义客户端应用使用您的 API 的方式。您可配置 ProxyEndpoint 来定义 API 代理的网址。代理端点还确定应用是通过 HTTP 还是 HTTPS 访问 API 代理。通常情况下,您可以将政策附加到 ProxyEndpoint 以强制执行安全性、配额检查,以及其他类型的访问权限控制和速率限制。
  • TargetEndpoint:定义 API 代理与后端服务互动的方式。您可配置 TargetEndpoint 以将请求转发到正确的后端服务,包括定义任何安全设置、HTTP 或 HTTPS 协议以及其他连接信息。您可以将政策附加到 TargetEndpoint,以确保针对发出初始请求的应用设置正确的响应消息格式。

如下图所示,您可以直观呈现 API 代理:

HTTP 请求通过代理请求端点进入,传递到目标请求端点,然后发送到后端服务。HTTP 响应通过目标响应端点进入,传递到代理响应端点,然后返回客户端。

如何创建 API 代理?

API 代理由一组 XML 配置文件和代码(例如 JavaScript 和 Java)组成。Apigee 为您提供了几种创建 API 代理的方法,其中包括:

  • 使用边缘管理界面在图形界面 (GUI) 中定义 API 代理。 如需了解详情,请参阅构建简单的 API 代理
  • 创建 XML 文件以及任何其他支持文件,用于定义 API 代理,然后将其导入 Edge。
  • 使用 Edge Management API 向 Edge 发出一系列 REST 请求,从而创建 API 代理。
  • 将 Node.js 应用部署为代理。请参阅部署独立的 Node.js 应用

什么是政策?

Edge 让您无需编写任何代码即可使用政策来控制 API 行为。在代理请求/响应流中,政策就像一个实现特定受限管理功能的模块。这些政策旨在让您能够轻松可靠地向 API 添加常见的管理功能类型。政策提供安全、速率限制、转换和中介功能等功能,让您无需自行编写代码和维护此功能。

创建您的第一个 API 代理

Apigee 提供了一系列教程,您可以使用这些教程来创建第一个 API。从构建您的第一个 API 代理开始。

如需了解 API 代理,请参阅使用示例 API 代理中介绍的示例。

了解详情