# 用 curl 快速測試 REST API：IT 人必學嘅命令行神技
做 IT 呢行，日日都要同 API 打交道。無論係測試自己寫嘅後端、檢查第三方服務、定係排查生產環境問題，識得用 **curl 測試 REST API** 係基本功。今日就同大家一步步拆解點樣用 curl 高效測試 REST API，包你睇完即刻上手。
## 咩係 curl？點解要學用 curl 測試 REST API
curl 係一個命令行工具，幾乎每個 Linux、macOS 系統都內置咗。佢可以發送 HTTP 請求，支援 GET、POST、PUT、DELETE 等所有方法，仲可以自訂 header、帶 cookie、上傳檔案。相比用 Postman 或者寫 script，用 curl 測試 REST API 快、輕量、而且可以入到自動化流程。
喺終端機入面打 `curl –version`，見到版本號就代表裝好咗。
## 第一步：發送最基本嘅 GET 請求
最簡單嘅用法，就係直接打網址：
curl https://api.example.com/users呢個命令會將 API 返回嘅 JSON 直接印喺螢幕。想睇埋 HTTP 狀態碼同 header，加 `-i`：
curl -i https://api.example.com/users輸出會先顯示 `HTTP/1.1 200 OK` 呢行，跟住先到 body。咁你就一眼睇到請求係咪成功。
## 第二步：POST 請求加 JSON 資料
要建立新資源，就要用 POST 方法，仲要喺 body 傳 JSON。記住三個關鍵 flag：
curl -X POST https://api.example.com/users \
-H "Content-Type: application/json" \
-d '{"name":"阿明","email":"ming@example.com"}'`-X` 指定 HTTP 方法，`-H` 加 header，`-d` 係 data。好多新手會漏咗 `Content-Type: application/json`，結果 server 唔知你傳緊 JSON，就會報 415 錯誤。
## 第三步：睇 Response Header 同格式化 JSON
API 返回嘅 JSON 通常都係一大串嘢，好難睇。可以用管道接去 `python3 -m json.tool` 或者 `jq` 嚟格式化：
curl -s https://api.example.com/users | python3 -m json.tool`-s` 係 silent mode，唔顯示進度條。想淨係睇 header，用 `-I`（HEAD 請求）或者 `-D -`：
curl -D - https://api.example.com/users -o /dev/null## 第四步：帶認證 Token 同自訂 Header
大部分 API 都要認證。Bearer Token 係最常見嘅做法：
curl https://api.example.com/me \
-H "Authorization: Bearer YOUR_TOKEN_HERE"如果係 Basic Auth，可以直接用 `-u`：
curl -u username:password https://api.example.com/me## 第五步：Debug 同排錯技巧
遇到問題時，`-v`（verbose）係你嘅好朋友。佢會顯示完整嘅請求和響應流程：
curl -v https://api.example.com/users想睇時間消耗，用 `-w` 加 format string：
curl -w "\n狀態碼:%{http_code} 總時間:%{time_total}秒\n" \
https://api.example.com/users## 總結
用 curl 測試 REST API 係每個 IT 人都應該掌握嘅技能。由最簡單嘅 GET，到帶認證、自訂 header、debug，一條命令就搞掂。熟練咗之後，你會發現排查問題快好多，寫 script 自動化亦方便得多。快啲打開終端機試下啦！
