~/教學/WAITER.md

文章 / 做 App

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 還剩幾台?」的網頁:捷運臺北車站(M2出口) 1 台可以借、16 個空位可以還,右邊列出送出的請求網址和端回來的 JSON
我自己電腦上跑的小 App(真實畫面):按下查詢,345 毫秒拿到回應,這一站剩 1 台、16 個空位。

這個網頁只做一件事:送一個請求到臺北市的 YouBike 即時資料網址,拿回全台北 1,824 個站的資料,再挑出捷運臺北車站(M2出口) 那一站,把「還能借幾台」「還能還幾台」放大顯示。整個串接就是這一個請求和一個回應。

  1. 用餐廳講懂 API:桌子、廚房、服務生、點菜單、端回來的菜各是什麼。
  2. 臺北 YouBike 即時資料:網址在哪裡、回來的 JSON 怎麼看。
  3. 叫 Claude Code 做這個網頁的提示詞,複製就能用。
  4. 要注意的事:授權要標示來源、有些 API 要金鑰、數字每分鐘都在變。

02API 是什麼:餐廳裡的服務生

Reels 畫面:紙做的餐廳,Claw'd 坐在餐桌旁,穿西裝的服務生把一盤寫著「剩 1 台」的菜端到桌上,旁邊是寫著廚房的門,上方蓋著「服務生=API」的章
Reels 畫面:服務生幫你點菜、進廚房、把菜端出來,他就是 API。

你坐在桌邊,菜在廚房。你不能自己衝進廚房翻冰箱,所以有服務生:你跟他點菜,他進廚房,再把菜端出來。換成程式的說法:

  1. 桌子=你的 App(使用者看得到的那一面)。
  2. 廚房=伺服器,資料和運算都在這裡,外人進不去。
  3. 服務生=API,替你把需求送進去、把結果帶出來,而且只照菜單上有的東西點。
  4. 點菜單=請求(request),通常就是一個網址,有時加上一些參數。
  5. 端回來的菜=回應(response),最常見的格式是 JSON,一種「欄位名稱:值」的文字。

所以你叫 Claude Code「串某某的 API」,它寫的就是這個服務生:知道要去哪個網址點菜、看得懂端回來的 JSON,再把你要的那一欄放到畫面上。

03點菜單:臺北 YouBike 即時資料的網址

政府資料開放平臺的資料集頁面「YouBike2.0臺北市公共自行車即時資訊」,寫著介接網址、主要欄位、提供機關臺北市政府交通局、更新頻率每1分、授權方式政府資料開放授權條款-第1版
政府資料開放平臺:資料集頁面寫著網址、欄位、更新頻率和授權。

臺北市政府交通局把 YouBike 2.0 每一站的即時狀況放在政府資料開放平臺,每 1 分鐘更新一次,免費,不用註冊也不用金鑰。點菜單就是這個網址,用瀏覽器直接打開就能看到 JSON:

YouBike 2.0 臺北市即時資料(請求網址)
https://tcgbusfs.blob.core.windows.net/dotapp/youbike/v2/youbike_immediate.json

這個網址一次回傳全台北所有站(我查的時候是 1,824 站),每一站是一筆資料。最常用的幾個欄位:

  1. sna:站名,例如 YouBike2.0_捷運臺北車站(M2出口)。
  2. ar:地址。
  3. available_rent_bikes:現在可以借的車數。
  4. available_return_bikes:現在可以還車的空位數。
  5. Quantity:這一站的總停車格數。
  6. updateTime:這筆資料的更新時間;latitude / longitude 是座標,可以拿來畫地圖。

04端回來的菜:看懂 JSON,再叫 Claude Code 做成網頁

深色面板:送出的請求網址,下面是端回來的 JSON,200 OK・345 ms,available_rent_bikes 1 和 available_return_bikes 16 兩行被標起來
真實畫面:這一站端回來的 JSON(只列幾個欄位),可以借 1 台、可以還 16 個。

在一個空的資料夾打開 Claude Code,把下面這段貼進去。[]裡換成你常去的站名(站名要跟資料裡的 sna 一字不差,可以先用瀏覽器打開網址搜尋):

貼給 Claude Code
幫我串 YouBike 的 API,做一個網頁:顯示[捷運臺北車站(M2出口)]那一站還剩幾台可以借、幾個空位可以還,加一個「查詢」按鈕,順便把送出的請求網址和這一站的原始 JSON 列出來,介面用繁體中文。資料網址:https://tcgbusfs.blob.core.windows.net/dotapp/youbike/v2/youbike_immediate.json
程式碼節錄:const URL_ 是 YouBike 的資料網址,async function go 裡用 fetch 送出請求、res.json() 讀回 JSON、all.find 用站名挑出那一站
Claude Code 寫的程式(節錄):fetch 是送出點菜單,find 是從整盤菜裡挑出你點的那一站。

跑起來之後,按一下查詢,網頁就會送出請求、拿回 JSON、把數字填進畫面。想再進一步,可以請 Claude 加上「每分鐘自動更新」或「列出我常用的三個站」,因為資料本來就是每分鐘更新一次。

05要注意

  1. 授權:這份資料用「政府資料開放授權條款-第1版」,可以免費使用、也可以商用,但一定要標示資料來源(提供機關、資料集名稱、授權條款),沒有標示就等於沒有取得授權。做成網頁時,在頁尾寫一行來源就好。
  2. 有些 API 要金鑰(API key),就像餐廳要你先報桌號,才知道帳要算給誰。例如 Claude 的 API 會從 Authorization 或 x-api-key 這個 header 讀你的金鑰。金鑰不要貼到網路上、截圖裡或 push 到 GitHub。
  3. 數字每分鐘都在變:影片和這篇的 1 台、16 個空位只是那一刻的狀況,不要拿來當作那一站平常的車量。
  4. 這個網址一次回傳全台北的站,大約 1 MB,不要每秒去問一次;跟著它每分鐘更新的節奏就夠了。
  5. 影片裡的網頁是我在自己電腦上跑的示範,不是 YouBike 官方 App;要借車、還車還是以官方 App 為準。

資料來源

延伸閱讀