术语库
本页面提供 API Gateway 文档中所用术语的简要定义以及指向更多信息的链接。
- API
- 可以让应用轻松使用来自其他应用的功能或数据的接口。通过定义稳定、简单且文档齐全的入口点，API 使开发者可以轻松访问和重复使用其他开发者构建的应用逻辑。
- API 配置
- 您在将 API 定义上传到 API Gateway 时创建。每次上传 API 定义时，API Gateway 都会创建新的 API 配置。也就是说，您可以创建 API 配置，但创建后就不能修改。如果您以后修改 API 定义，然后上传修改后的 API 定义，则会创建新的 API 配置。
- API 定义
- 用于创建 API 配置的 Open API 2.0 规范或 gRPC 配置。API 定义指定：后端服务的网址、请求中传递的数据的数据格式、服务返回的任何数据的数据格式、用于控制对服务的访问权限的身份验证机制，等等。
- API 密钥
- 客户端应用在调用 API 时传入的代码。API 密钥表明向 API 发出调用的应用或 Google Cloud 项目的身份。如需详细了解如何将 API 密钥用于 API Gateway API，请参阅为何及何时使用 API 密钥。
- Auth0
- 一项可让您定义用户如何向应用进行身份验证的服务。如需了解详情，请参阅 Auth0。
- CORS
- 跨域资源共享 (CORS) 是一种规范，可让 Web 应用访问另一个网域（从技术上讲，是另一个来源）中服务器上的资源。如需详细了解 CORS，请参阅 Mozilla 开发者网络 (MDN) Web 文档和 Fetch 现行标准。
- Firebase 身份验证
- Google 的身份验证服务，支持最终用户使用 Google、Facebook 或 Twitter 等热门联合身份提供商的凭据登录客户端应用。如需了解详情，请参阅 Firebase 身份验证。
- 网关
- 基于 Envoy 的可扩缩高性能代理，用于托管已部署的 API 配置。创建网关会创建面向外部的网址，您的 API 客户端可使用该网址访问 API。网关只托管单个 API 配置。您不能将多个 API 配置部署到同一网关。
- Google ID 令牌
- 一种 JSON Web 令牌 (JWT)，包含识别 Google 用户账号或服务账号所需的 OpenID Connect 字段，并由 Google 的身份验证服务 (
https://accounts.google.com) 签名。 - gRPC
- 由 Google 开发的高性能开源通用 RPC 框架。 在 gRPC 中，客户端应用可以直接从不同机器调用服务器应用上的方法，就像它是本地对象一样。请参阅gRPC 概览了解如何将 gRPC 与 API Gateway 配合使用以及参阅 gRPC 网站了解常规信息。
- JWT
- JSON Web 令牌是一种开放式标准访问令牌格式，可用于 HTTP 授权标头和 URI 查询参数。如需了解常规信息，请参阅 JSON 网络令牌简介。
- OpenAPI
- Open API Initiative 是一项业界共同努力的项目，旨在实现 REST API 的标准化描述。用于为客户端和服务器创建文档、自动执行测试和生成代码的常用工具均支持 OpenAPI 规范（以前称为 Swagger 规范）所描述的 API。如需了解详情，请参阅 OpenAPI 概览。
- OpenAPI 文档
- 用于描述 API 的 YAML 或 JSON 格式的文件。此文件也称为 API 定义。上传到 API Gateway 时，OpenAPI 文档将转换为 API 配置。
- 表面
- API 的公共接口。API 的 Surface 由方法以及这些方法中使用的参数和返回类型组成。