Cloud Mock

Cloud Mock 是 Apidog 的雲端託管 Mock 伺服器，提供 24/7 可用性 和 全團隊存取。與 Local Mock（在您的電腦上執行）不同，Cloud Mock 部署在 Apidog 的伺服器上，使其可以隨時隨地被存取。

在這篇文章中，我們將學習如何為 Pet Store API 啟用和使用 Cloud Mock，實現更好的團隊協作和持續可用性。

1. 什麼是 Cloud Mock？

Cloud Mock 是託管在 Apidog 雲端基礎設施上的 Mock 伺服器。與 Local Mock（在您的電腦上執行）不同，Cloud Mock 在 Apidog 的伺服器上執行，提供：

24/7 可用性：即使您的電腦關閉也能運作

全團隊存取：所有團隊成員共享相同的 Mock URL

隨處存取：從任何設備或地點使用它

協管理想之選：非常適合團隊開發、公開文件和 CI/CD 流程

Cloud Mock vs. Local Mock

功能	Local Mock	Cloud Mock
位置	您的電腦	Apidog 的伺服器
可用性	僅當 Apidog 開啟時	24/7，始終可用
存取	個人（每個團隊成員有自己的）	共享（全團隊）
最適合	本地開發和除錯	團隊協作、公開 API、CI/CD

2. 何時使用 Cloud Mock

在以下情況下使用 Cloud Mock：

團隊協作：多個開發人員需要存取相同的 Mock 資料

持續整合：CI/CD 流程需要始終可用的 Mock 端點

公開文件：在公開 API 文件中分享 Mock API

遠端存取：從不同設備或地點存取 Mock 資料

穩定測試：需要不依賴個人機器的 Mock 端點

3. 啟用 Cloud Mock

讓我們為您的 Pet Store API 專案啟用 Cloud Mock：

步驟 1：打開專案設定

在您的 Apidog 專案中，點擊 Settings 圖標（通常在右上角）

選擇 "Project Settings"

導航到 "Mock Settings"

步驟 2：啟用 Cloud Mock

找到 "Cloud Mock" 開關

將其開啟 ON

Cloud Mock 現在已為您的專案啟用

4. 使用 Cloud Mock

啟用後，您可以透過幾種方式存取 Cloud Mock：

方法 1：獲取 Cloud Mock URL

打開專案中的任何端點（例如 GET /pets/{id}）

切換到 "Mock" 分頁

點擊 "Cloud Mock" 按鈕

複製 Cloud Mock URL

URL 看起來像：

https://mock.apidog.com/m1/1138249-1130478-default/pets/{id}

例如，要獲取 ID 為 pet_1Nv0FGQ9RKHgCVdK 的寵物：

https://mock.apidog.com/m1/1138249-1130478-default/pets/pet_1Nv0FGQ9RKHgCVdK

方法 2：使用 Request 按鈕

在 Mock 分頁中，點擊 "Request" 按鈕

Apidog 將向 Cloud Mock 伺服器發送請求

在回應面板中檢視回應

方法 3：切換環境

在右上角，點擊 environment switcher（環境切換器）

從下拉選單中選擇 "Cloud Mock"

Apidog 中的所有請求現在都將發送到 Cloud Mock 而不是實際 API

5. 存取控制（可選）

為了安全性，您可以為 Cloud Mock 啟用 Token 驗證：

啟用 Token 驗證

前往 Project Settings → Mock Settings

將 Access Permission 設定為 "Token Authentication"

將為您的專案生成一個 Token

使用經過驗證的 Cloud Mock

啟用 Token 驗證後，您需要在請求中包含 Token：

選項 1：URL 參數

https://mock.apidog.com/m1/1138249-1130478-default/pets/pet_1Nv0FGQ9RKHgCVdK?apidogToken=YOUR_TOKEN

選項 2：Header 參數

將 apidogToken 新增到您的請求標頭中：

apidogToken: YOUR_TOKEN

選項 3：Body 參數（用於 form-data 或 x-www-form-urlencoded）

將 apidogToken 新增到您的請求 Body 參數中。

6. 範例：使用 Cloud Mock 與 Pet Store API

讓我們看看 Cloud Mock 的實際操作：

步驟 1：啟用 Cloud Mock

在 Project Settings 中啟用 Cloud Mock（如上所示）

步驟 2：獲取 Cloud Mock URL

打開 GET /pets/{id} 端點

前往 Mock 分頁

點擊 "Cloud Mock" 獲取 Cloud Mock URL

步驟 3：測試 Cloud Mock

複製 Cloud Mock URL

將 {id} 替換為寵物 ID（例如 pet_1Nv0FGQ9RKHgCVdK）

將 URL 貼上到您的瀏覽器中或在您的應用程式中使用

您將從雲端收到 Smart Mock 生成的資料

範例 URL：

https://mock.apidog.com/m1/1138249-1130478-default/pets/pet_1Nv0FGQ9RKHgCVdK

範例回應：

{
  "id": "pet_1Nv0FGQ9RKHgCVdK",
  "species": "CAT",
  "name": "Whiskers",
  "breed": "Domestic Shorthair",
  "ageMonths": 18,
  "size": "MEDIUM",
  "color": "Orange Tabby",
  "gender": "MALE",
  "goodWithKids": true,
  "goodWithPets": true,
  "adoptionFee": 75,
  "description": "Friendly and playful orange tabby looking for a loving home",
  "status": "AVAILABLE",
  "intakeDate": "2024-06-15",
  "photos": [
    "https://cdn.petstoreapi.com/pets/pet_1Nv0FGQ9RKHgCVdK/photo1.jpg",
    "https://cdn.petstoreapi.com/pets/pet_1Nv0FGQ9RKHgCVdK/photo2.jpg"
  ],
  "medicalInfo": {
    "spayedNeutered": true,
    "vaccinated": true,
    "microchipped": true,
    "specialNeeds": false
  }
}

您也可以測試其他端點，例如：

List Pets：GET https://mock.apidog.com/m1/1138249-1130478-default/pets

Create Pet：POST https://mock.apidog.com/m1/1138249-1130478-default/pets

步驟 4：與您的團隊分享

與您的團隊成員分享 Cloud Mock URL。他們可以使用相同的 URL 存取相同的 Mock 資料，確保團隊之間的一致性。

7. 關鍵重點

Cloud Mock 為 Mock API 提供 24/7 可用性和全團隊存取

始終可用：即使您的電腦關閉也能運作

團隊協作：所有團隊成員共享相同的 Mock URL

易於啟用：只需在 Project Settings 中開啟即可

存取控制：可選的 Token 驗證以確保安全

多種存取方法：URL、Request 按鈕或環境切換

相同功能：支援 Smart Mock、Mock Expectations 和 Mock Scripts

Cloud Mock 為您的 Mock API 實現無縫的團隊協作和持續可用性。在下一篇文章中，我們將學習 Mock Scripts——如何建立動態 Mock 回應，保持請求和回應資料之間的邏輯關係。

繼續閱讀 → Mock Scripts

1. 什麼是 Cloud Mock？#

Cloud Mock vs. Local Mock#

2. 何時使用 Cloud Mock#

3. 啟用 Cloud Mock#

步驟 1：打開專案設定#

步驟 2：啟用 Cloud Mock#

4. 使用 Cloud Mock#

方法 1：獲取 Cloud Mock URL#

方法 2：使用 Request 按鈕#

方法 3：切換環境#

5. 存取控制（可選）#

啟用 Token 驗證#

使用經過驗證的 Cloud Mock#

6. 範例：使用 Cloud Mock 與 Pet Store API#

步驟 1：啟用 Cloud Mock#

步驟 2：獲取 Cloud Mock URL#

步驟 3：測試 Cloud Mock#

步驟 4：與您的團隊分享#

7. 關鍵重點#