跳到主要內容
Cypher's Practical Coding
正在準備工作環境...

curl 實戰:不用寫程式也能打 API

你有沒有想過,工程師常說的「打 API 拿資料」,其實不用寫任何程式?一行 curl 指令就能搞定。學會這個,你就能自己測試 API、驗證資料,不用每次都等工程師。

你會學到什麼

  • curl 發送 GET 和 POST 請求
  • -H 設定 header(例如 Content-Type)
  • -d 帶資料送出
  • -w 查看 HTTP status code
  • -o 把回應存成檔案

觀念速記

  • curl = 「Client URL」,就是用終端機當瀏覽器,直接跟伺服器對話。
  • GET = 拿資料(像打開網頁);POST = 送資料(像送出表單)。
  • HTTP Status Code:200 = 成功、404 = 找不到、500 = 伺服器壞了。

範例操作

常用 curl 參數速查

參數用途範例
-H設定 HTTP Header-H "Content-Type: application/json"
-d帶資料(自動變 POST)-d '{"key":"value"}'
-X指定 HTTP 方法-X POST-X PUT
-o輸出存到檔案-o result.json
-s安靜模式(不顯示進度)-s
-w自訂輸出格式-w "%{http_code}"
-i顯示 response header-i

實戰:確認電商促銷 API 是否正常

假設行銷活動上線前,你想確認促銷 API 有沒有正確回傳資料:

小提醒:-s(silent)很常搭配其他參數用,避免進度條干擾輸出。工作中測 API 時幾乎都會加。

AI 協作:學了這個,跟 AI 怎麼配合?

curl 是 API 測試的瑞士刀。當你學會基本用法,就能看懂 API 文件裡的範例,也能跟 AI 更精準溝通。

你的人類優勢:

  • 你知道要測哪個 API、帶什麼參數——這是業務知識,AI 不知道
  • 你能判斷回傳結果是否符合預期(例如折扣金額對不對)

可以這樣跟 AI 說:

我要用 curl 測試我們的訂單查詢 API,endpoint 是 https://api.shop.com/orders?status=pending,需要帶 Bearer token。幫我組一個 curl 指令,並且只顯示 HTTP 狀態碼。

小練習

互動示範

DEMO 1可以修改程式碼試玩
DEMO 2可以修改程式碼試玩

挑戰任務

Task 1

用 curl 取得匯率 API 的資料(https://api.exchangerate-api.com/v4/latest/USD),並只顯示 HTTP 狀態碼

Task 2

用 curl 發送一個 POST 請求到 https://httpbin.org/post,帶 JSON 資料 {"item":"衛生紙","qty":3},並設定 Content-Type header

Task 3

用 curl 把 https://api.exchangerate-api.com/v4/latest/USD 的結果存到 rates.json 檔案(安靜模式)

Next Lesson →