練習 - 匯入並發佈 API

已完成

現在您的閘道已設定，接下來即可匯入並發佈 API，如此，夥伴即可存取庫存和產品資訊。

在此，您將匯入要公開 OpenAPI 端點的 Web API。 然後，您會使用視覺效果來測試匯入的 API。 最後，您會發佈 API。

注意

此練習會使用您在上一個練習中設定的資源。

匯入 API

此練習的第一個部分是將 NorthWind Shoes API 匯入 API 管理閘道中。

1. 在 Azure 入口網站資源功能表中，或從 [首頁] 中，選取 [所有資源]，然後選取您的 API 管理服務。

2. 在 [API 管理服務] 功能表的 [API] 底下，選取 [API]，然後選取 [+ 新增 API]。

3. 在 [從定義建立] 底下，選取 [OpenAPI]。 [從 OpenAPI 規格建立] 窗格隨即出現。

   

4. 在 OpenAPI 規格視窗中，完成下列設定：

   設定	值
   OpenAPI 規格	貼上您從先前的練習中儲存的 Swagger JSON URL。
   顯示名稱	接受預設值，應該是 NorthWindShoes Products。
   名稱	接受預設值，應該是 northwindshoes-products。
   API URL 尾碼	忽略此設定。
   基礎 URL	接受預設值。

   注意

   您將注意到在輸入 JSON URL 後，系統會為您自動填入其他數個欄位。 這是因為我們使用了 OpenAPI，其會指定所有必要的連線詳細資料。

5. 選取建立。 [apim-NorthwindShoesNNNN | API] 窗格會顯示 NorthWindShoes 產品 API 的所有作業。

將 API 視覺化

此練習的最後一個部分是測試 API，並使用兩個測試來將結果視覺化。 首先，發出以單一參數傳遞的基本 GET 要求。

1. 在 [apim-NorthwindShoesNNNN | APIs] 窗格上，選取 NorthWindShoes 產品 API，然後選取 [測試] 索引標籤。

2. 選取第一個 GET 作業：尋找指定產品的詳細資料。 詳細資料會出現在測試主控台中。

3. 在 [範本參數] 底下，輸入產品識別碼參數的數值。

   

4. 向下捲動，並注意 [要求 URL] 會包含 /api/Products/{productid} 尾碼。

5. 請選取傳送。

   您應該會收到對 GET 要求的 200 OK 回應，以及您輸入產品識別碼的詳細資料。

   現在，測試使用基本的 GET 要求，而不搭配任何參數。

6. 選取第三個 GET 作業 (擷取公司的整個產品清查)，並確定已選取 [測試] 索引標籤。

   

7. 向下捲動，並注意 [要求 URL] 會包含 /api/Inventory 尾碼。

8. 請選取傳送。

   您應該會在承載中收到對 GET 要求的 200 OK 回應，以及所有產品庫存 (庫存量) 的詳細資料。