API Proxy 教戰手冊模式

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

本主題將討論 Apigee Edge 食譜範例中示範的部分 API Proxy 開發模式。我們計畫在本主題中新增更多模式,並陸續加入更多食譜範例。

JavaScript HTTP 用戶端模式

JavaScript HTTP 用戶端模式是您可用來透過 Apigee Edge 建立伺服器端混搭的模式之一。Apigee 的 JavaScript 物件模型可讓您直接將 JavaScript 程式碼連線至 API Proxy 流程。物件模型的 httpClient 物件可讓您呼叫後端服務,並使用 JavaScript 擷取結果。

政策組合模式

政策組合是 Apigee API Proxy 模式,可讓您使用政策,將多個後端目標的結果合併為單一回應。實際上,政策組合可讓您使用政策建立混搭。

政策組合模式的核心是 ServiceCallout 政策。 ServiceCallout 政策會做為後端 API 或服務的 HTTP 用戶端。不過,如要發揮完整功能,ServiceCallout 必須依賴其他政策,才能與遠端 API 或服務進行有意義的互動。其他政策則用於產生 ServiceCallout 傳送的要求訊息,以及剖析遠端 API 或服務回應訊息中的內容。

政策組合食譜範例使用三項政策:AssignMessageServiceCalloutExtractVariables。這些政策會封裝您要傳送至後端的要求訊息、將訊息路由至後端的用戶端,以及剖析各個 API 回應並為回應資料指派變數的訊息剖析器。所有呼叫完成後,系統會合併收集到的變數,並以單一 JSON 物件的形式傳回。

以下簡要說明這三項政策:

  • AssignMessage:建立要求訊息、填入 HTTP 標頭和查詢參數,並設定 HTTP 動詞。
  • ServiceCallout:參照 AssignMessage 政策建立的訊息,定義外部呼叫的目標網址,以及目標服務傳回的回應物件名稱。
  • ExtractVariables:通常會定義 JSONPath 或 XPath 運算式,用來剖析前一個 ServiceCallout 政策產生的訊息。接著,政策會設定包含從 ServiceCallout 回應剖析值的變數。

如需示範政策組合模式的完整範例,請參閱「使用政策組合」。