如何呼叫 API？

呼叫 API 意味著實際發送請求並處理回應——而不僅僅是閱讀相關內容。在本文中，我們將使用來自 WeatherAPI.com 的倫敦天氣作為真實 API 範例，並展示如何使用 Apidog 來試用它。我們將保持內容適合初學者。

1. 呼叫 API 之前的準備

在呼叫 API 之前，您通常需要：

一個 端點 URL（您發送請求的地方）

正確的 HTTP 方法（GET、POST 等）

任何需要的參數（查詢字串、路徑片段）

可能需要的標頭（驗證、內容類型）

有時需要一個 Body（用於 POST/PUT）

您可以透過兩種主要方式發送 API 請求：編寫程式碼（使用像 Python 的 requests 或 JavaScript 的 fetch 的函式庫）或 使用 API 工具 像 Apidog。

在本指南中，我們將為了方便而使用 Apidog，因為它允許您輕鬆發送請求並視覺化回應，而無需設定複雜的開發環境。

對於我們的範例，我們將使用 WeatherAPI.com 的當前天氣 API，這需要您註冊，獲取 API key，然後將 key 作為查詢參數發送。

2. 請求（如何發送）

什麼是 WeatherAPI.com？

WeatherAPI.com 是一個完全託管的天氣和地理位置 API 提供商，提供即時天氣、預報、歷史天氣、空氣品質資料等。

您需要先在 WeatherAPI 註冊以獲取 API key 才能繼續。

範例請求

這是一個準備好發送的請求（將 YOUR_API_KEY 替換為您註冊後獲得的實際 key）：

GET http://api.weatherapi.com/v1/current.json?key=3432a351afd04b30bef75833252711&q=London&aqi=no

方法：GET — 檢索資料

URL：Base URL http://api.weatherapi.com/v1/current.json，參數 key = 您的 API key，q = “London”，aqi=no 跳過空氣品質資料

在這個簡單案例中不需要額外的標頭或請求 body

什麼是 Apidog？

Apidog 是一個一體化 API 協作平台，用於 API 文件、API 除錯、API Mock 和 API 自動化測試。它提供了一個視覺化介面來輕鬆發送 HTTP 請求和檢查回應，使其成為命令列工具或基本 HTTP 客戶端的強大替代方案。

Apidog 實作步驟

以下是如何使用 Apidog 發送此請求：

登入 Apidog 並選擇 New Endpoint。

將 Method 設定為 GET。

將此 URL 貼上到請求 URL 欄位中。別忘了將 key 替換為您自己的 key。
http://api.weatherapi.com/v1/current.json?key=3432a351afd04b30bef75833252711&q=London&aqi=no

（可選）新增一個描述性名稱像「獲取即時天氣」。

點擊 Send 按鈕。Apidog 將發送請求並顯示即時回應。

這樣做您就啟動了一個針對倫敦天氣資料的真實 API 呼叫。

3. 回應（您得到什麼）

Apidog 實作步驟

發送請求後，您將在請求區域下方看到回應。

以下是如何在 Apidog 中 檢查回應：

在您發送請求（上一節）之後，查看 Apidog 中的 回應面板。您應該看到狀態碼 200，加上回應時間和 JSON Body。

展開 JSON Body 以檢視 daily_units、daily.time、daily.temperature_2m_max 等欄位。

在 Apidog 中儲存請求以便您可以重複使用它。

（可選）將查詢參數 q 更改為不同的城市（例如 q=New York）並重新發送請求以查看回應如何變化。

範例回應

HTTP/1.1 200 OK  
Headers: (ignored for simplicity)

{
    "location": {
        "name": "London",
        "region": "City of London, Greater London",
        "country": "United Kingdom",
        "lat": 51.5171,
        "lon": -0.1062,
        "tz_id": "Europe/London",
        "localtime_epoch": 1764232379,
        "localtime": "2025-11-27 08:32"
    },
    "current": {
        "last_updated_epoch": 1764232200,
        "last_updated": "2025-11-27 08:30",
        "temp_c": 11.2,
        "temp_f": 52.2,
        "is_day": 1,
        "condition": {
            "text": "Overcast",
            "icon": "//cdn.weatherapi.com/weather/64x64/day/122.png",
            "code": 1009
        },
        "wind_mph": 10.1,
        "wind_kph": 16.2,
        "wind_degree": 225,
        "wind_dir": "SW",
        "pressure_mb": 1015.0,
        "pressure_in": 29.97,
        "precip_mm": 0.0,
        "precip_in": 0.0,
        "humidity": 94,
        "cloud": 100,
        "feelslike_c": 9.3,
        "feelslike_f": 48.7,
        "windchill_c": 8.0,
        "windchill_f": 46.3,
        "heatindex_c": 10.2,
        "heatindex_f": 50.3,
        "dewpoint_c": 9.0,
        "dewpoint_f": 48.2,
        "vis_km": 10.0,
        "vis_miles": 6.0,
        "uv": 0.0,
        "gust_mph": 17.1,
        "gust_kph": 27.5,
        "short_rad": 0.68,
        "diff_rad": 0.31,
        "dni": 11.17,
        "gti": 0.0
    }
}

狀態碼 200 OK：表示請求成功。

Body 包含倫敦的當前天氣，包括溫度 (11.2 °C)、狀況（“Overcast”）、風速、濕度等。

您的前端或客戶端現在可以使用這些值顯示給使用者。

透過在 Apidog 中檢查回應，您完成了閉環：請求 → 回應 → 使用。

您也可以直接在這裡訪問此請求：Get realtime weather。

4. 關鍵重點

呼叫 API = 發送請求 + 處理回應。

您現在知道如何使用真實 URL、方法，發送您的 API key，並透過 WeatherAPI.com 查看倫敦當前天氣的真實回應。

使用像 Apidog 這樣的工具將理論轉化為實踐。

下一步：嘗試使用不同的城市或參數（例如預報端點）呼叫 API，或使用帶有請求 body 的 POST/PUT 方法呼叫其他 API。

呼叫 API 就是發送正確的請求並知道如何讀取返回的回應。但是我們如何知道應該在參數或 body 中發送什麼？我們應該如何組成請求？

在下一篇文章中，我們將分解如何閱讀 API 文件，讓您可以充滿信心地理解任何 API 並正確呼叫它。

1. 呼叫 API 之前的準備#

2. 請求（如何發送）#

什麼是 WeatherAPI.com？#

範例請求#

什麼是 Apidog？#

Apidog 實作步驟#

3. 回應（您得到什麼）#

Apidog 實作步驟#

範例回應#

4. 關鍵重點#

1. 呼叫 API 之前的準備

2. 請求（如何發送）

什麼是 WeatherAPI.com？

範例請求

什麼是 Apidog？

Apidog 實作步驟

3. 回應（您得到什麼）

Apidog 實作步驟

範例回應

4. 關鍵重點