瞭解 API 和 API Proxy

本頁適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

Apigee 可讓您輕鬆快速地建構 RESTful API，供應用程式開發人員使用。您可以建立 API Proxy，做為後端服務的受管理「外觀」，藉此在 Apigee 上公開 API。本主題將討論 Apigee 中的 API 和 API Proxy 之間的關係。

影片：請觀看這部短片，瞭解 API Proxy 的相關資訊。

什麼是 API？

API 是一種介面，可讓一個應用程式輕鬆使用其他應用程式的功能或資料。透過定義應用程式邏輯和資料的穩定簡化進入點，開發人員就能輕鬆存取及重複使用其他開發人員建構的應用程式邏輯。在 Web API 的情況下，這些邏輯和資料會透過網路公開。

由於使用 API 的應用程式對變更十分敏感，因此 API 也暗示了合約。這份合約可提供一定程度的保證，讓您知道 API 會以可預測的方式隨時間變更。

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

Apigee 還可讓您透過在 API 服務平台上代管的應用程式，建構 API，而無需涉及後端服務。您可以使用 JavaScript 和 Java 建構這些應用程式。

什麼是 API Proxy？

您可以透過實作 API Proxy，在 Apigee 上公開 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 視覺化，如以下圖表所示：

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

API Proxy 類型

Apigee 支援兩種 Proxy 類型：

  • 標準 Proxy 僅包含標準政策。標準 Proxy 適用於輕量級 API 解決方案，且無法納入 API 產品。
  • 可擴充 Proxy 至少包含一個可擴充政策或流程掛鉤。可擴充的 Proxy 可包含比標準 Proxy 更多功能。

如何建立 API Proxy？

API Proxy 包含一組 XML 設定檔和程式碼 (例如 JavaScript 和 Java)。Apigee 提供多種建立 API Proxy 的方式，包括：

  • 使用 Apigee UI 在圖形使用者介面 (GUI) 中定義 API Proxy。詳情請參閱「建構簡單的 API Proxy」。
  • 建立 XML 檔案和其他支援檔案，定義 API Proxy，然後將這些檔案匯入 Apigee。
  • 使用 Apigee API 向 Apigee 提出一系列 REST 要求，藉此建立 API Proxy。
  • 在 VS Code 中使用 Apigee 在本機開發，並以封存檔形式部署。詳情請參閱「透過 Apigee 本機開發的總覽」

什麼是 API Proxy 修訂版本？

API Proxy 修訂版本提供輕量級機制，可在您進行疊代時管理 API Proxy 設定的更新。修訂版本會依序編號，因此您可以部署 API Proxy 的先前修訂版本，藉此還原變更。您可以透過修訂版本將 API Proxy 部署至實際執行環境，同時在測試環境中繼續建立該 API Proxy 的新修訂版本。準備就緒後，您可以升級 API 代理程式的較新版本，從測試環境推送至實際工作環境。

什麼是政策？

您可以使用 Apigee 的政策，在不編寫任何程式碼的情況下，控制 API 行為。政策就像模組一樣，會在 Proxy 要求/回應流程中實作特定的受限管理功能。政策可讓您輕鬆且可靠地將常見類型的管理功能新增至 API。政策提供安全性、頻率限制、轉換和中介服務等功能，讓您不必自行編寫程式碼和維護這類功能。

建立第一個 API Proxy

Apigee 提供一系列教學課程，可用來建立第一個 API。請先參閱「建構第一個 API Proxy」一文。另請參閱其他入門主題。

瞭解詳情