使用 API Gateway 主控台來建立具有 HTTP 代理整合的 API。測試具有 HTTP 代理整合的 API

教學課程：使用 HTTP 代理整合建立 REST API

HTTP 代理整合是建置 API 的簡單、功能強大且多樣化的機制，可讓 Web 應用程式存取整合式 HTTP 端點 (例如整個網站) 的多個資源或功能，以簡化單一 API 方法的設定。在 HTTP 代理整合中，API Gateway 會將用戶端提交的方法請求傳遞至後端。傳遞的請求資料包含請求標頭、查詢字串參數、URL 路徑變數和承載。後端 HTTP 端點或 Web 伺服器會剖析傳入請求資料，以判斷其所傳回的回應。在設定 API 方法之後，HTTP 代理整合可讓用戶端和後端直接互動，而不需要 API Gateway 介入，除了 Amazon API Gateway 重要備註所列的一些已知問題，例如不支援的字元。

使用全能代理資源 {proxy+}，以及 HTTP 方法的 catch-all ANY 動詞，您可以使用 HTTP 代理整合來建立單一 API 方法的 API。此方法會公開網站的整個可公開存取的 HTTP 資源和操作集。後端 Web 伺服器開啟更多資源來進行公開存取時，用戶端可以搭配使用這些新的資源與相同的 API 設定。若要啟用此功能，網站開發人員必須與用戶端開發人員清楚地溝通新資源以及每個新資源適用的操作。

下列教學是快速簡介，可示範 HTTP 代理整合。在教學課程中，我們使用 API Gateway 主控台建立 API，透過一般代理資源與 PetStore網站整合{proxy+}，並建立的 HTTP 方法預留位置ANY。

使用 API Gateway 主控台來建立具有 HTTP 代理整合的 API。

下列程序會逐步解說如何使用 API Gateway 主控台，建立和測試具有 HTTP 後端之代理資源的 API。HTTP 後端是「PetStore」中的 http://petstore-demo-endpoint.execute-api.com/petstore/pets 網站 (教學課程：使RESTAPI用HTTP非代理整合建立)；其中，螢幕擷取畫面是用來顯示提醒，以說明 API Gateway UI 元素。如果您是第一次使用 API Gateway 主控台來建立 API，則建議您先遵循該節。

若要建立 API

在以下網址登入 API Gateway 主控台：https://console.aws.amazon.com/apigateway。
如果這是您第一次使用 API Gateway，您會看到服務功能的介紹頁面。在 REST API 下方，選擇 Build (組建)。當 Create Example API (建立範例 API) 快顯出現時，選擇 OK (確定)。

如果這不是第一次使用 API Gateway，請選擇 Create API (建立 API)。在 REST API 下方，選擇組建。
對於API 名稱，輸入 HTTPProxyAPI。
在描述，請輸入描述。
將 API 端點類型保持設定為區域。
選擇建立 API。

在此步驟中，您會建立 {proxy+} 的代理資源路徑。這是 http://petstore-demo-endpoint.execute-api.com/ 下方之任何後端端點的預留位置。例如，它可以是 petstore、petstore/pets 和 petstore/pets/{petId}。API Gateway 會在您建立 {proxy+} 資源時建立 ANY 方法，並在執行時間將該方法作為任何受支援 HTTP 動詞的預留位置。

建立 /{proxy+} 資源

選擇您的 API。
在主導覽窗格中，選擇資源。
選擇建立資源。
開啟代理資源。
將資源路徑保持為 /。
針對資源名稱，輸入 {proxy+}。
讓 CORS (跨來源資源分享) 保持關閉。
選擇建立資源。

在此步驟中，您會使用代理整合將 ANY 方法與後端 HTTP 端點整合。在代理整合中，API Gateway 會將用戶端提交的方法請求傳遞至後端，而不需要 API Gateway 介入。

建立 `ANY` 方法

選擇 /{proxy+} 資源。
選擇 ANY 方法。
在警告符號下，選擇編輯整合。如果 API 的方法沒有整合，便無法部署該 API。
針對整合類型，選取 HTTP。
開啟 HTTP 代理整合。
針對 HTTP 方法，選取 ANY。
針對端點 URL，輸入 http://petstore-demo-endpoint.execute-api.com/{proxy}。
選擇儲存。

測試具有 HTTP 代理整合的 API

特定用戶端請求成功與否取決於下列項目：

如果後端已讓對應的後端端點可供使用，因此已授予所需的存取許可。
如果用戶端提供正確的輸入。

例如，此處使用的 PetStore API 不會公開資/petstore源。因此，您會取得包含錯誤訊息 404 Resource Not Found 的 Cannot GET /petstore 回應。

此外，用戶端必須能夠處理後端的輸出格式，才能正確地剖析結果。API Gateway 不會居中來促進用戶端與後端之間的互動。

通過代理資源使用 HTTP 代理集成來測試與 PetStore 網站集成的 API

選取測試索引標籤。您可能需要選擇向右箭頭按鈕才能顯示此索引標籤。
針對方法類型，選取 GET。
針對路徑，在代理下輸入 petstore/pets。
針對查詢字串，輸入 type=fish。
選擇測試。

因為後端網站支援 GET /petstore/pets?type=fish 請求，所以它會傳回與下列類似的成功回應：
```
[
  {
    "id": 1,
    "type": "fish",
    "price": 249.99
  },
  {
    "id": 2,
    "type": "fish",
    "price": 124.99
  },
  {
    "id": 3,
    "type": "fish",
    "price": 0.99
  }
]
```
如果您嘗試呼叫 GET /petstore，則會取得具有錯誤訊息 404 的 Cannot GET /petstore 回應。原因是後端不支援指定的操作。如果您打電話GET /petstore/pets/1，則會收到具有以下有效負載的200 OK響應，因為該請求受 PetStore網站支持。
```
{
  "id": 1,
  "type": "dog",
  "price": 249.99
}
```

您也可以使用瀏覽器來測試您的 API。部署您的 API 並將其關聯到某個階段，以建立 API 的調用 URL。

部署 API

選擇部署 API。
針對階段，選取新階段。
針對階段名稱，輸入 test。
在描述，請輸入描述。
選擇部署。

現在，用戶端可以呼叫您的 API。

若要調用您的 API

在以下網址登入 API Gateway 主控台：https://console.aws.amazon.com/apigateway。
選擇您的 API。
在主導覽窗格中，選擇階段。
在階段詳細資訊下，選擇複製圖示以複製 API 的調用 URL。

在 Web 瀏覽器中輸入 API 的調用 URL。

完整 URL 看起來應該會像這樣：https://abcdef123.execute-api.us-east-2.amazonaws.com/test/petstore/pets?type=fish。

您的瀏覽器將向 API 傳送 GET 請求。
結果應該與在 API Gateway 主控台中使用測試時所傳回的結果相同。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

選擇一個 HTTP 整合教學課程

教學課程：使RESTAPI用HTTP非代理整合建立