Google API 设计指南－词汇表

翻译自 API Design Guide - Glossary

网络 API（Networked APIs）

• 通过计算机网络中运行的应用程序接口。它们使用包括 HTTP 在内的网络协议进行通信，并且生产和消费 API 的往往是不同的组织。

Google API

• Google 服务的网络 API。大部分在 googleapis.com 域名上。不包括客户端库和 SDK 等其他类型的 API。

<span id="interface">API 接口（API Interface）</span>

• 一个 Protocol Buffer 服务的定义。在大多数编程语言中它被映射到一个接口。一个 API 接口可以被多个 API 服务实现。

<!--more-->

<span id="version">API 版本（API Version）</span>

• 一个 API 接口或多个定义在一起的 API 接口的版本。API 版本通常以字符串表示（例如 "v1"）并且以 API 请求和 Protocol Buffer 的包名表示。

API 方法（API Method）

• API 接口中的一个单独操作。在 Protocol Buffer 中以 rpc 定义，并且在大多数编程语言中映射到 API 接口中的一个函数。

API 请求（API Request）

• 一个单独的 API 方法调用。它经常用作计费、记录、监控和速率限制的单位。

<span id="service">API 服务（API Service）</span>

• 一人部署了暴露出网络端点的 API 接口的实现。API 服务以 RFC 1035 DNS 格式的服务名（例如 calendar.googleapis.com）进行标识。

API 端点（API Endpoint）

• 指向用于 API 服务处理实际 API 请求的网络地址。例如 pubsub.googleapis.com 和 content-pubsub.googleapis.com。

API 产品（API Product）

• 一个 API 服务加上相关的组件（服务声明、文档、客户端库和服务支持），组合起来以产品的形式提供给用户。例如 Google Calendar API。注意：人们有时会简单地使用 API 表示 API 产品。

API 服务定义（API Service Definition）

• API 接口的定义（.proto 文件）和 API 服务配置（.yaml 文件）一起定义了API 服务

API 消费者（API Consumer）

• 消费 API 服务的实体。对于 Google API，API 消费者一般是拥有客户端程序或服务端资源的 Google 项目。

API 生产者（API Producer）

• 产生 API 服务的实体。对于 Google API，API 生产者一般是拥有 API 服务的 Google 项目。

API 后端（API Backend）

• 为 API 服务实现了业务逻辑的一组服务和相关的基础设施。

API 前端（API Frontend）

• 通过 API 服务提供通用功能的一组服务和相关的基础设施，例如负载均衡器和认证服务器。注意：API 前端和后端可能距离很近也可能很远。有时它们可能会编译成一个二进制文件并运行在一个进程中。

查看其他章节