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

若要建立 API

1. 在 https://console.aws.amazon.com/apigateway 登入API閘道主控台。

2. 如果這是您第一次使用 API Gateway，您會看到一個頁面，向您介紹 服務的功能。在 REST API下，選擇建置 。出現建立範例API快顯視窗時，選擇確定 。

   如果這不是您第一次使用 API Gateway，請選擇建立 API。在 REST API下，選擇建置 。

3. 針對API名稱 ，輸入 HTTPNonProxyAPI。

4. 在描述，請輸入描述。

5. 將API端點類型設定為區域 。

6. 選擇建立 API。

建立 /pets 資源

1. 選擇建立資源。

2. 讓代理資源保持關閉。

3. 將資源路徑保持為 /。

4. 針對資源名稱，輸入 pets。

5. 保持關閉 CORS （跨原始伺服器資源共用）。

6. 選擇建立資源。

在 /pets 資源上建立 GET 方法

1. 選取 /pets 資源。

2. 選擇建立方法。

3. 針對方法類型，選取 GET。

4. 針對整合類型 ，選取HTTP整合 。

5. 保持HTTP代理整合關閉。

6. 對於HTTP方法 ，選取 GET。

7. 對於端點 URL，輸入 http://petstore-demo-endpoint.execute-api.com/petstore/pets。

   PetStore 該網站可讓您在指定頁面上依寵物類型擷取Pet項目清單，例如「狗」或「貓」。

8. 針對內容處理，選取傳遞。

9. 選擇URL查詢字串參數 。

   PetStore 網站使用 type和 page查詢字串參數來接受輸入。您可以將查詢字串參數新增至方法請求，並將其映射至整合請求的對應查詢字串參數。

10. 若要新增查詢字串參數，請執行下列動作：

    1. 選擇新增查詢字串。

    2. 對於名稱，輸入 type。

    3. 將必要和快取保持關閉。

    重複上述步驟，另外建立名稱為 page 的查詢字串。

11. 選擇建立方法。

將輸入參數映射至整合請求

1. 在整合請求索引標籤上，於整合請求設定下，選擇編輯。

2. 選擇URL查詢字串參數 ，然後執行下列動作：

   1. 選擇新增查詢字串參數。

   2. 針對名稱，輸入 type。

   3. 對於映射自，輸入 method.request.querystring.type。

   4. 讓快取保持關閉。

   5. 選擇新增查詢字串參數。

   6. 針對名稱，輸入 page。

   7. 對於映射自，輸入 method.request.querystring.page。

   8. 讓快取保持關閉。

3. 選擇 Save (儲存)。

若要測試 API

1. 選擇測試標籤。您可能需要選擇向右箭頭按鈕才能顯示此索引標籤。

2. 針對查詢字串，輸入 type=Dog&page=2。

3. 選擇測試。

   結果類似如下：

   

   現在測試成功，我們可以部署 API以公開提供。

4. 選擇部署API。

5. 針對階段，選取新階段。

6. 針對階段名稱，輸入 Prod。

7. 在描述，請輸入描述。

8. 選擇部署。

9. （選用） 在 階段詳細資訊 下，針對叫用 URL，您可以選擇複製圖示以複製 API的叫用 URL。您可以搭配 Postman 和 cURL 等工具來測試您的 API。

若要建立 {petId} 資源

1. 選取 /pets 資源，然後選擇建立資源。

2. 讓代理資源保持關閉。

3. 針對資源路徑，選取 /pets。

4. 針對資源名稱，輸入 {petId}。

   周圍使用捲曲支架 （{ }），petId以顯示 /pets/{petId}。

5. 保持關閉 CORS （跨原始伺服器資源共用）。

6. 選擇建立資源。

設定GET方法

1. 選取 /{petId} 資源，然後選擇建立方法 。

2. 針對方法類型，選取 GET。

3. 針對整合類型 ，選取HTTP整合 。

4. 保持HTTP代理整合關閉。

5. 對於HTTP方法 ，選取 GET。

6. 對於端點 URL，輸入 http://petstore-demo-endpoint.execute-api.com/petstore/pets/{id}

7. 針對內容處理，選取傳遞。

8. 讓預設逾時保持開啟。

9. 選擇建立方法。

映射 {petId} 路徑參數

1. 在整合請求索引標籤上，於整合請求設定下，選擇編輯。

2. 選擇URL路徑參數 。

3. API Gateway 會為名為 的整合請求建立路徑參數petId，但此路徑參數對您URL設定為後端整合的HTTP端點無效。HTTP 端點使用 {id}作為路徑參數。對於名稱 ，刪除 petId並輸入 id。

   這會將 petId 的方法請求路徑參數對應到 id 的整合請求路徑參數。

4. 選擇儲存。

測試該方法

1. 選擇測試標籤。您可能需要選擇向右箭頭按鈕才能顯示此索引標籤。

2. 在 的路徑下petId，輸入 4。

3. 選擇測試。

   若成功，回應內文會顯示如下：

   {
     "id": 4,
     "type": "bird",
     "price": 999.99
   }

部署 API

1. 選擇部署API。

2. 對於階段，選取生產。

3. 在描述，請輸入描述。

4. 選擇部署。

1. 在主導覽窗格中，選擇階段。

2. 在階段詳細資訊 下，選擇複製圖示以複製 API的叫用 URL。

   此 URL 看起來如下：

   https://my-api-id.execute-api.region-id.amazonaws.com/prod

3. URL 在新瀏覽器索引標籤的地址方塊中輸入此選項，並在提交請求URL之前附加/pets/4到 。

4. 瀏覽器會傳回以下內容：

   {
     "id": 4,
     "type": "bird",
     "price": 999.99
   }