您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
ProxyEndpoint 設定會定義用戶端應用程式透過 Apigee Edge 使用 API 的方式。ProxyEndpoint 會定義 API Proxy 的網址,以及 Proxy 的行為方式:要套用哪些政策、要轉送至哪些目標端點,以及執行這些政策或轉送規則時必須符合的條件。
簡而言之,ProxyEndpoint 設定會定義實作 API 所需完成的所有工作。
反模式
API Proxy 可含有一或多個 Proxy 端點。定義多個 ProxyEndpoint 是一種簡單的機制,可在單一 Proxy 中實作多個 API。這樣一來,您就能在呼叫 TargetEndpoint 之前和之後重複使用政策和/或商業邏輯。
另一方面,如果在單一 API Proxy 中定義多個 ProxyEndpoint,最終會在概念上將許多不相關的 API 合併為單一構件。這會讓 API Proxy 更難閱讀、理解、偵錯及維護。這違背了 API Proxy 的主要理念:讓開發人員輕鬆建立及維護 API。
影響
API Proxy 中的多個 ProxyEndpoint 可執行以下操作:
- 開發人員難以瞭解及維護 API Proxy。
- 模糊處理數據分析。根據預設,數據分析資料會在 Proxy 層級匯總。除非您建立自訂報表,否則系統不會依代理程式端點細分指標。
- 難以排解 API Proxy 問題。
最佳做法
在導入新的 API Proxy 或重新設計現有 API Proxy 時,請採用下列最佳做法:
- 使用單一 ProxyEndpoint 實作一個 API Proxy。
- 如果有多個 API 共用相同的目標伺服器,且/或需要在呼叫目標伺服器前或後使用相同的邏輯,建議您使用共用流程,在不同的 API Proxy 中實作這類邏輯。
- 如果有多個 API 共用相同的起始基本路徑,但後置字串不同,請在單一 ProxyEndpoint 中使用條件式流程。
- 如果有 API proxy 包含多個 ProxyEndpoint,且沒有任何問題,則不必採取任何行動。
每個 API Proxy 使用一個 ProxyEndpoint 會導致:
- 簡化代理程式,讓維護工作更輕鬆
- Analytics 會針對中介效能和目標回應時間等更詳細的資訊,分別回報,而非為所有 ProxyEndpoints 匯總
- 加快疑難排解和問題解決速度