你的第一個真實 API
從你真的終端機呼叫 JSONPlaceholder — 一個免費的公開 API
⏱ 預估 ~11 分鐘
01 · 讀一讀
目前為止你呼叫的都是 mock API。現在來呼叫真的。
JSONPlaceholder(jsonplaceholder.typicode.com)是一個免費的公開假 API,幾百萬工程師拿來測試跟學習。不用註冊、不用 API key、不用信用卡。
它有真的 endpoint、真的 JSON 回應,行為跟 production API 一模一樣 — 練習的最佳工具。
重點整理
- JSONPlaceholder 是免費、公開、不需要驗證的
- 它有 users、posts、todos、comments、albums、photos 的 endpoint
- 回應是假資料,但格式跟真 API 一模一樣
- 這課用你真的機器的終端機(不是 sandbox)
02 · 真機練習
打開你真的終端機(不是 sandbox)。確認 curl 可以用。Windows PowerShell 使用者: 這課的所有指令都用 curl.exe 而不是 curl。
curl --version
03 · 真機練習
撈一筆 todo。這是對真實 server 的真實 GET 請求。
curl https://jsonplaceholder.typicode.com/todos/1
04 · 真機練習
撈所有使用者。這會回傳 10 個使用者物件的陣列 — 掃過 JSON 看看結構。
curl https://jsonplaceholder.typicode.com/users
05 · 讀一讀
看看你目前做到什麼:你確認 curl 裝好了、撈了單一資源、從網路上的活 server 撈了整批使用者。每個回應都是結構化的 JSON — 真實 app 每天用的同一種格式。
接下來你要走得更遠。你會學怎麼用 query parameter 過濾結果(這樣不用整批下載)、用 POST 請求建立新資源。這兩個模式撐起你手機上大部分的 app。
06 · 真機練習
用 query parameter 過濾:只拿 user ID 1 的 post。
curl "https://jsonplaceholder.typicode.com/posts?userId=1"
07 · 真機練習
POST 一筆新資源。JSONPlaceholder 接受 POST 請求,會回「建立好」的資源(含 ID)— 但真正沒存。
curl -X POST https://jsonplaceholder.typicode.com/posts \
-H "Content-Type: application/json" \
-d '{"title": "My First Post", "body": "Hello from curl!", "userId": 1}'08 · 選擇題
什麼是 JSONPlaceholder?
- 一個 JavaScript 函式庫
- 一個資料庫服務
- 免費的假 API,給人測試跟學習用
- 一個程式碼編輯器
09 · 填空
在終端機裡用 _____ 指令可以從命令列呼叫 HTTP API。
⚠ 完整互動體驗需要 JavaScript。請啟用 JavaScript 後重新整理。
※ 本站為獨立繁中教學專案,非 Anthropic 官方產品。Claude™ 為 Anthropic, PBC 商標。