您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
Apigee Edge 可讓您輕鬆快速建構 RESTful API,供應用程式開發人員使用。您可以建立 API Proxy,讓後端服務充當代管的「外觀」,藉此在 Edge 上公開 API。本主題將討論 Apigee Edge 中的 API 和 API Proxy 之間的關係。
影片:請觀看這部短片,瞭解 API Proxy 的相關資訊。
什麼是 API?
API 是一種介面,可讓一個應用程式輕鬆「使用」另一個應用程式的功能或資料。透過定義應用程式邏輯和資料的穩定簡化進入點,API 可讓開發人員輕鬆存取及重複使用其他開發人員建構的應用程式邏輯。如果是「Web API」,則該邏輯和資料會透過網路公開。
由於使用 API 的應用程式對變更十分敏感,因此 API 也暗示了「合約」。這份合約可提供一定程度的保證,讓您知道 API 會以可預測的方式隨時間變更。
Apigee Edge 可讓您建構 API,如果您已有 API,則可直接公開這些 API,同時新增管理和瀏覽權限層。如果您有啟用 HTTP 的服務 (例如以 SOA 為基礎的 Web 服務),也可以透過 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。您通常會將policies附加至 ProxyEndpoint,以便強制執行安全性、配額檢查和其他類型的存取權控管和速率限制。
- TargetEndpoint:定義 API Proxy 與後端服務互動的方式。您可以設定 TargetEndpoint,將要求轉送至適當的後端服務,包括定義任何安全性設定、HTTP 或 HTTPS 通訊協定,以及其他連線資訊。您可以將policies附加至 TargetEndpoint,確保回應訊息格式正確,以便應用程式執行初始要求。
您可以將 API Proxy 視覺化,如以下圖表所示:
如何建立 API Proxy?
API Proxy 包含一組 XML 設定檔和程式碼 (例如 JavaScript 和 Java)。Apigee 提供多種建立 API Proxy 的方式,包括:
- 使用 Edge 管理 UI 在圖形使用者介面 (GUI) 中定義 API Proxy。詳情請參閱「建構簡單的 API Proxy」。
- 建立 XML 檔案和其他支援檔案,定義 API 代理程,然後將這些檔案匯入 Edge。
- 使用 Edge 管理 API 向 Edge 提出一系列 REST 要求,藉此建立 API Proxy。
- 將 Node.js 應用程式部署為 Proxy。請參閱「部署獨立的 Node.js 應用程式」。
政策是什麼?
您可以使用 Edge 的policies,在不編寫任何程式碼的情況下,控制 API 行為。政策就像模組一樣,會在 Proxy 要求/回應流程中實作特定的受限管理功能。政策可讓您輕鬆且可靠地將常見類型的管理功能新增至 API。政策提供安全性、頻率限制、轉換和中介服務等功能,讓您不必自行編寫程式碼並維護這項功能。
建立第一個 API Proxy
Apigee 提供一系列教學課程,可用來建立第一個 API。請先參閱「建構第一個 API Proxy」一文。
如要瞭解 API Proxy,建議您參考「使用 API Proxy 範例」一文,並運用範例。