瞭解 API 和 API Proxy

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

Apigee Edge 可讓您輕鬆快速地建構符合 REST 樣式的 API,供應用程式開發人員使用。建構 API Proxy 來當做後端服務的代管「門面」,藉此在 Edge 上公開 API。本主題說明 Apigee Edge 中 API 和 API Proxy 之間的關係。

影片:請觀看這部短片,瞭解 API Proxy 簡介。

什麼是 API?

API 介面可讓一個應用程式輕鬆「使用」的功能或其他應用程式的資料。透過定義穩定、簡化的進入點至應用程式邏輯和資料,開發人員便能輕鬆存取及重複使用其他開發人員建構的應用程式邏輯。以「Web API」為例,該邏輯和資料會透過網路公開。

由於使用 API 的應用程式屬於機密資訊,因此 API 也暗示應用程式屬於「合約」。合約提供一定程度的保證,API 會隨時間改變,以可預測的方式變更。

Apigee Edge 可讓您建構 API。如果您已有 API,可直接提供 API,同時新增管理和瀏覽權限層。如果已啟用 HTTP 的服務 (例如以 SOA 為基礎的網路服務),您也可以透過 Apigee Edge 以 API 的形式公開這些服務。

此外,Edge 也能讓您實作託管於 API 服務平台的應用程式,藉此建構 API,完全不需要後端服務。您可以使用 JavaScript、Java 和 Node.js 建構這些應用程式。

什麼是 API Proxy?

您可以透過實作 API Proxy,在 Apigee Edge 上公開 API。API Proxy 會將應用程式導向的 API 與後端服務分離,防止這些應用程式的後端程式碼變更。當您對服務進行後端變更時,應用程式會繼續呼叫相同的 API,不會中斷。

在 API Proxy 設定中,端點分為兩種類型:

  • ProxyEndpoint:定義用戶端應用程式使用 API 的方式。您需要設定 ProxyEndpoint,以定義 API Proxy 的網址。Proxy 端點也能決定應用程式要透過 HTTP 或 HTTPS 存取 API Proxy。通常會將政策附加至 ProxyEndpoint,以強制執行安全性、配額檢查,以及其他類型的存取權控管和頻率限制。
  • TargetEndpoint:定義 API Proxy 與後端服務互動的方式。您設定 TargetEndpoint,使其將要求轉送至適當的後端服務,包括定義任何安全性設定、HTTP 或 HTTPS 通訊協定,以及其他連線資訊。您可以將政策附加至 TargetEndpoint,確保發出初始要求的應用程式回應訊息格式正確無誤。

您可以按照下圖所示,以視覺化方式呈現 API Proxy:

透過 Proxy 要求端點輸入的 HTTP 要求,會傳遞至目標要求端點,然後傳送至後端服務。透過目標回應端點輸入的 HTTP 回應,會傳遞至 Proxy 回應端點,然後再傳回用戶端。

如何建立 API Proxy?

API Proxy 是由 XML 設定檔和程式碼 (例如 JavaScript 和 Java) 組成。Apigee 可讓您以多種方式建立 API Proxy,包括:

  • 使用邊緣管理 UI 在圖形使用者介面 (GUI) 中定義 API Proxy。詳情請參閱建構簡單的 API Proxy
  • 建立 XML 檔案和其他支援檔案以定義 API Proxy,然後匯入至 Edge。
  • 使用 Edge Management API 向 Edge 發出一系列 REST 要求,藉此建立 API Proxy。
  • 將 Node.js 應用程式部署為 Proxy。請參閱部署獨立 Node.js 應用程式

政策是什麼?

Edge 可讓您透過政策控管 API 行為,無須編寫任何程式碼。政策就像模組,可實作特定的有限管理功能,做為 Proxy 要求/回應流程的一部分。政策旨在讓您以輕鬆可靠的方式將常見的管理功能新增至 API。政策提供安全性、頻率限制、轉換和中介服務等功能,因此您不必自行編寫程式碼及維護這項功能。

建立第一個 API Proxy

Apigee 提供一組教學課程,方便您用來建立第一個 API。請先從建構第一個 API Proxy 開始著手。

如要瞭解 API Proxy,根據「使用範例 API Proxy」中的說明使用範例。

瞭解詳情