一支刻意做到最小的後端 API。兩個端點、一張表、六條驗證。
這是半天課用的程式。課堂上你只用 Postman,什麼都不用裝; 這份說明是給課後想自己跑起來、自己改的你。
需要 Node 22 以上。 這支程式用的 node:sqlite 是 Node 22 才內建的,
舊版會直接報「找不到模組」。先確認:
node -v然後:
npm install
node --watch server.js開 http://localhost:3000/ping,看到 {"ok":true} 就成功了。
開起來會印一行紅字 ExperimentalWarning: SQLite is an experimental feature。
那是 Node 對 node:sqlite 的固定警告,不是錯誤,不用管。
| 檔案 | 裡面有什麼 | 什麼時候開 |
|---|---|---|
server.js |
**完成版。**兩個端點、六條驗證都在裡面 | 想直接玩、想對答案 |
server.start.js |
**空白起點。**只有 /ping |
想自己從頭做一次 |
下面的範例都是對 server.js 跑的。
如果你開的是 server.start.js,POST /scores 會回 404 Cannot POST /scores
—— 那不是壞掉,是那兩個端點還沒寫,要你自己補。
| 打什麼 | 做什麼 | 回什麼 |
|---|---|---|
POST /scores |
檢查你送的資料,沒問題就存進資料庫 | 201 和那筆資料 |
GET /scores/top |
撈前十名,排好、編號 | 200 和一個陣列 |
送一筆:
curl -s -X POST http://localhost:3000/scores \
-H 'Content-Type: application/json' \
-d '{"name":"阿明","score":1200}'{"id":1,"name":"阿明","score":1200}
看排行榜:
curl -s http://localhost:3000/scores/top[{"rank":1,"name":"小美","score":3400},
{"rank":2,"name":"阿明","score":1200},
{"rank":3,"name":"阿華","score":800}]
還有一個排行榜網頁,開 http://localhost:3000/ 就看得到。
POST /scores 的資料要通過六道檢查才存得進去。任何一道沒過就回 400。
| # | 檢查 | 沒過的回應 |
|---|---|---|
| 1 | 有 name 和 score 嗎 | {"error":"name 和 score 都是必填"} |
| 2 | name 是文字、score 是數字嗎 | {"error":"name 必須是文字,score 必須是數字"} |
| 3 | name 去掉空白後不是空的嗎 | {"error":"name 不能是空白"} |
| 4 | name 不超過 16 個字嗎 | {"error":"name 最多 16 個字"} |
| 5 | score 是 0 以上的整數嗎 | {"error":"score 必須是 0 以上的整數"} |
| 6 | score 不超過 1000000 嗎 | {"error":"score 不能超過 1000000"} |
順序有意義。 先問「有沒有送」,再問「型別對不對」,最後才問「值合不合理」。
把第 3 條搬到第 1 條前面,送一筆沒有 name 的資料,程式會當掉回 500
—— 你不能對一個不存在的東西呼叫 .trim()。
400是「你送錯了」,我擋下來了。500是「我壞了」,這是我的問題。 兩個都是錯,但要修的人不一樣。
| 檔案 | 是什麼 |
|---|---|
server.js |
完成版,兩個端點加六條驗證。平常跑這支 |
server.start.js |
空白起點,只有 /ping。想自己做一次就開這支 |
public/index.html |
排行榜網頁 |
scores.db |
資料庫,跑起來自動產生 |
想從頭做一次,就開 server.start.js 自己補那兩個端點,卡住再開 server.js 對答案。
rm scores.db然後按 Ctrl+C 把 server 關掉重開。 只刪檔案沒有用——
跑著的程式還抓著那個已經被刪掉的檔案在讀寫,API 會繼續回舊資料。
重開才會建一個新的空資料庫。
幫 POST /scores 加一條規則:同一個名字,只保留最高分。
提示:先 SELECT 查有沒有這個名字,再決定要 INSERT 還是 UPDATE。
| 選擇 | 理由 |
|---|---|
| Express | 最少行數就能跑起一支 API |
node:sqlite(Node 22 內建) |
不裝原生套件。原本用 better-sqlite3,在開發機上直接 segfault |
唯一相依套件是 express |
裝不起來的機率降到最低 |
| 不用 TypeScript | 半天課,型別會變成干擾 |