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 前端和後端可能距離很近也可能很遠。有時它們可能會編譯成一個二進制文件並運行在一個進程中。

查看其餘章節