~/教學/WAITER.md
API 是什麼?就是餐廳的服務生:用臺北 YouBike 即時資料,叫 Claude Code 串一個真的 API
桌子是 App、廚房是伺服器、服務生是 API。看懂之後,用不用金鑰的 YouBike 開放資料實際串一次:網址、JSON、提示詞,和要注意的授權。
常聽到「串 API」,但 API 到底是什麼?想像去餐廳吃飯:菜在廚房,你進不去,所以有服務生幫你點菜、進廚房、把菜端出來。那個服務生就是 API。這篇是 Reels 裡 WAITER 那支的完整版:先用餐廳把 API、請求、回應、JSON 講清楚,再用臺北市政府公開的 YouBike 即時資料實際串一次。不用註冊、不用金鑰,提示詞可以直接複製給 Claude Code。資料集和授權條款我在 2026 年 11 月 12 日核對過。
01先看結果:台北車站 YouBike 還剩幾台,我的 App 一秒就知道

這個網頁只做一件事:送一個請求到臺北市的 YouBike 即時資料網址,拿回全台北 1,824 個站的資料,再挑出捷運臺北車站(M2出口) 那一站,把「還能借幾台」「還能還幾台」放大顯示。整個串接就是這一個請求和一個回應。
- 用餐廳講懂 API:桌子、廚房、服務生、點菜單、端回來的菜各是什麼。
- 臺北 YouBike 即時資料:網址在哪裡、回來的 JSON 怎麼看。
- 叫 Claude Code 做這個網頁的提示詞,複製就能用。
- 要注意的事:授權要標示來源、有些 API 要金鑰、數字每分鐘都在變。
02API 是什麼:餐廳裡的服務生

你坐在桌邊,菜在廚房。你不能自己衝進廚房翻冰箱,所以有服務生:你跟他點菜,他進廚房,再把菜端出來。換成程式的說法:
- 桌子=你的 App(使用者看得到的那一面)。
- 廚房=伺服器,資料和運算都在這裡,外人進不去。
- 服務生=API,替你把需求送進去、把結果帶出來,而且只照菜單上有的東西點。
- 點菜單=請求(request),通常就是一個網址,有時加上一些參數。
- 端回來的菜=回應(response),最常見的格式是 JSON,一種「欄位名稱:值」的文字。
所以你叫 Claude Code「串某某的 API」,它寫的就是這個服務生:知道要去哪個網址點菜、看得懂端回來的 JSON,再把你要的那一欄放到畫面上。
03點菜單:臺北 YouBike 即時資料的網址

臺北市政府交通局把 YouBike 2.0 每一站的即時狀況放在政府資料開放平臺,每 1 分鐘更新一次,免費,不用註冊也不用金鑰。點菜單就是這個網址,用瀏覽器直接打開就能看到 JSON:
https://tcgbusfs.blob.core.windows.net/dotapp/youbike/v2/youbike_immediate.json
這個網址一次回傳全台北所有站(我查的時候是 1,824 站),每一站是一筆資料。最常用的幾個欄位:
- sna:站名,例如 YouBike2.0_捷運臺北車站(M2出口)。
- ar:地址。
- available_rent_bikes:現在可以借的車數。
- available_return_bikes:現在可以還車的空位數。
- Quantity:這一站的總停車格數。
- updateTime:這筆資料的更新時間;latitude / longitude 是座標,可以拿來畫地圖。
04端回來的菜:看懂 JSON,再叫 Claude Code 做成網頁

在一個空的資料夾打開 Claude Code,把下面這段貼進去。[]裡換成你常去的站名(站名要跟資料裡的 sna 一字不差,可以先用瀏覽器打開網址搜尋):
幫我串 YouBike 的 API,做一個網頁:顯示[捷運臺北車站(M2出口)]那一站還剩幾台可以借、幾個空位可以還,加一個「查詢」按鈕,順便把送出的請求網址和這一站的原始 JSON 列出來,介面用繁體中文。資料網址:https://tcgbusfs.blob.core.windows.net/dotapp/youbike/v2/youbike_immediate.json

跑起來之後,按一下查詢,網頁就會送出請求、拿回 JSON、把數字填進畫面。想再進一步,可以請 Claude 加上「每分鐘自動更新」或「列出我常用的三個站」,因為資料本來就是每分鐘更新一次。
05要注意
- 授權:這份資料用「政府資料開放授權條款-第1版」,可以免費使用、也可以商用,但一定要標示資料來源(提供機關、資料集名稱、授權條款),沒有標示就等於沒有取得授權。做成網頁時,在頁尾寫一行來源就好。
- 有些 API 要金鑰(API key),就像餐廳要你先報桌號,才知道帳要算給誰。例如 Claude 的 API 會從 Authorization 或 x-api-key 這個 header 讀你的金鑰。金鑰不要貼到網路上、截圖裡或 push 到 GitHub。
- 數字每分鐘都在變:影片和這篇的 1 台、16 個空位只是那一刻的狀況,不要拿來當作那一站平常的車量。
- 這個網址一次回傳全台北的站,大約 1 MB,不要每秒去問一次;跟著它每分鐘更新的節奏就夠了。
- 影片裡的網頁是我在自己電腦上跑的示範,不是 YouBike 官方 App;要借車、還車還是以官方 App 為準。
資料來源
下一支 Reel 想學什麼?
我每天測 Claude 和 AI 工具,把真的有用的做成 Reel。追蹤 @vivianlin.tech,新教學一出來就看得到。