一、API 是什么？

API 是 Application Programming Interface（應用程序編程接口） 的縮寫。

通俗解釋：

API 就像是不同軟件系統之間溝通的“橋梁”或“服務員”。
它讓程序員可以不用了解軟件內部的實現細節，就能使用某些功能或數據。

類比理解：

• API 像餐廳菜單：
  你在菜單（API）上選擇要的菜（功能），然后廚房（系統內部）完成制作，最后服務員（API）將結果給你。

• API 像電源插座：
  你把設備插上去（調用 API），它幫你接通電（系統資源），你不需要知道電廠怎么發電（底層實現）。

二、API 的分類

根據使用方式不同，API 可以分為以下幾種：

三、Web API 詳解（重點）

1. 工作原理

一個 Web API 通常基于 客戶端-服務器模型：

[客戶端瀏覽器/程序] ——> 發出 HTTP 請求 ——> [API 服務器]
                              |
[客戶端瀏覽器/程序] <—— 返回 JSON/XML 數據 <——

2. 常見協議和格式

• 協議：HTTP 或 HTTPS

• 常見請求方法（HTTP Methods）：

  方法	含義	說明
  GET	獲取資源	查詢數據（如獲取用戶信息）
  POST	創建資源	提交數據（如新建訂單）
  PUT	更新資源	修改數據（如更新用戶資料）
  DELETE	刪除資源	刪除數據（如注銷賬戶）

• 數據格式：

  • JSON（最常用）：輕量、可讀性強
  • XML：傳統格式，現在較少使用

四、一個簡單的 API 示例

假設我們要使用一個天氣 API，查詢某城市的天氣。

請求示例（GET）：

GET https://api.weatherapi.com/v1/current.json?key=你的API密鑰&q=Beijing

返回結果（JSON）：

{
  "location": {
    "name": "Beijing",
    "country": "China"
  },
  "current": {
    "temp_c": 30.2,
    "condition": {
      "text": "Sunny"
    }
  }
}

你就可以拿這些數據在自己的網頁或程序中展示天氣情況了。

五、如何使用 API？（從小白到動手）

Step 1：獲取 API 文檔

幾乎所有公開 API 都會有官方文檔，介紹如何調用、參數說明、響應示例等。

Step 2：申請 API Key（如果需要）

一些服務要求你注冊賬號，獲取密鑰用于身份驗證。

Step 3：發起請求（可以用工具或代碼）

推薦工具：

• Postman（圖形界面，適合測試）
• curl（命令行）
• 瀏覽器（適合 GET 請求）

示例代碼（Python）：

import requests

url = "https://api.weatherapi.com/v1/current.json"
params = {
    "key": "你的API密鑰",
    "q": "Beijing"
}

response = requests.get(url, params=params)
data = response.json()
print(data["current"]["temp_c"])

六、API 的優勢

七、學習建議

八、常見術語解釋

九、總結一句話

API 是現代程序交流的語言，是你調用“外部服務”的鑰匙。
掌握 API，等于你能把自己的程序連接到整個互聯網的智慧和能力上。