建立及匯出測試資源

本頁適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

在測試 API 之前，您可能需要建構一組測試資源，例如 API 產品、開發人員或應用程式，這些資源代表 Apigee 組織實際執行環境中可能存在的資源。

請按照下列各節所述，建立及匯出測試資源。另請參閱「在 Apigee 工作區中管理資料夾和檔案」。

建構測試資源

如要建構測試資源，請建立測試套件，然後編輯下表中定義的測試資源。

建立測試套件

如要在 Cloud Code 中建立測試套件，請按照下列步驟操作：

1. 執行下列任一操作：

   • 將游標移至 Apigee 工作區中的「test data」資料夾，然後按一下 。

   • 依序選取「View」>「Command Palette」開啟指令面板，然後選取「Cloud Code: Create Apigee test bundle」。

2. 輸入測試套件的專屬名稱，然後按下 Enter 鍵。

測試套件會新增至 Apigee 專區的「測試資料」資料夾。

按照下列各節的說明設定測試資源。

定義 API 產品 (products.json)

定義用於將 API 整合成套件的 API 產品，並提供給開發人員使用。如要進一步瞭解 API 產品，請參閱「什麼是 API 產品？」。

如要定義 API 產品，請使用設定精靈更新 products.json 檔案，或直接編輯 products.json 設定檔。如需 products.json 檔案中欄位的說明，請參閱「資源：ApiProduct」。

如要使用設定精靈定義 API 產品，請按照下列步驟操作：

1. 將游標移至測試套件的 products.json 檔案，然後按一下 。「Create API product」精靈會隨即開啟。

   

2. 輸入 API 產品的名稱，然後逐步完成設定精靈，即可自動填入 products.json 檔案中的欄位。products.json 檔案會在編輯器中開啟。

3. 視需要編輯設定資訊。

4. 選取「File」>「Save」或按下 ⌘S 鍵即可儲存編輯內容。

以下範例定義包含 helloworld API Proxy 的 myapiproduct API 產品。

[
  {
    "apiResources": [
      "/",
      "/*",
      "/**"
    ],
    "quota": "100",
    "quotaInterval": "1",
    "quotaTimeUnit": "minute",
    "name": "myapiproduct",
    "displayName": "My first API product",
    "proxies": [
      "helloworld"
    ]
  }
]

註冊開發人員 (developers.json)

註冊將存取 API 的開發人員。如要進一步瞭解開發人員，請參閱「註冊應用程式開發人員」。

如要註冊開發人員，請使用設定精靈更新 developers.json 檔案，或直接編輯 developers.json 設定檔。如需 developers.json 檔案中欄位的說明，請參閱「資源：開發人員」。

如要使用設定精靈註冊開發人員，請按照下列步驟操作：

1. 將滑鼠游標移至測試套件的 developers.json 檔案，然後按一下 。
2. 在設定精靈中輸入開發人員電子郵件地址和其他值，即可自動填入 developers.json 檔案中的欄位。developers.json 檔案會在編輯器中開啟。
3. 視需要編輯設定。
4. 選取「File」>「Save」或按下 ⌘S 鍵即可儲存編輯內容。

以下範例定義開發人員 ahamilton@example.com：

[
  {
    "email": "ahamilton@example.com",
    "userName": "ahamilton",
    "firstName": "Alex",
    "lastName": "Hamilton"
  }
]

註冊開發人員應用程式 (developerapps.json)

註冊開發人員應用程式，控管 API 存取權。如要進一步瞭解如何註冊開發人員應用程式，請參閱「註冊應用程式來控管 API 存取權」。

如要註冊開發人員應用程式，請使用設定精靈更新 developerapps.json 檔案，或直接編輯 developerapps.json 設定檔。如需 developerapps.json 檔案中欄位的說明，請參閱「資源：DeveloperApp」。

如要使用設定精靈註冊開發人員應用程式，請按照下列步驟操作：

1. 將滑鼠游標移至測試套件的 developerapps.json 檔案，然後按一下 。

2. 選取開發人員和其他值，以便在 developerapps.json 檔案中自動填入欄位。developerapps.json 檔案會在編輯器中開啟。

3. 視需要編輯設定。

4. 選取「File」>「Save」或按下 ⌘S 鍵即可儲存編輯內容。

以下範例會為 ahamilton@example.com 註冊開發人員應用程式 myapp，並關聯 myproduct：

[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "developerEmail": "ahamilton@example.com",
    "name": "myapp",
    "callbackUrl": "",
    "keyExpiresIn": "",
    "apiProducts": [
      "myproduct"
    ]
  }
]

定義鍵/值對應 (maps.json)

定義 API 用來儲存資料的鍵/值對應 (KVM)，以便在執行階段擷取資料。如要進一步瞭解 KVM，請參閱「使用鍵/值對應」。

如要定義鍵值對應，請使用設定精靈更新 maps.json 檔案，或是直接編輯 maps.json 設定檔。如需 maps.json 檔案中欄位的說明，請參閱 KeyValueMap 資源。

如要使用設定精靈定義 KVM，請按照下列步驟操作：

1. 將游標移至測試套件的 maps.json 檔案，然後按一下 。
2. 選取範圍和其他值，以便在 maps.json 檔案中自動填入欄位。maps.json 檔案會在編輯器中開啟。
3. 視需要編輯設定。
4. 選取「File」>「Save」或按下 ⌘S 鍵即可儲存編輯內容。

以下範例會定義 mykvm 加密的 KVM：

[
  {
    "name": "mykvm",
    "encrypted": true
  }
]

將測試資源匯出至 Apigee 模擬器

如何將測試資源匯出至 Apigee 模擬器：

1. 將游標移至要匯出的測試套件，然後按一下 。

   

2. 如果有多個 Apigee Emulator 容器正在執行，請選取要部署環境的容器。

如下圖所示，Apigee Emulator 會顯示有效的測試資源。

查看測試資源內容，取得特定資源資訊，例如用於測試的API 金鑰，這類資訊會自動產生並納入開發人員應用程式測試資源。