資料後端｜Web Dev Glossary

GET /api/urls

POST /api/urls

DELETE /api/urls/5

REST API

以 HTTP 動詞和資源路徑設計的 API 架構風格

POST
/api/admin/urls
→ 201 Created

端點

Endpoint

API 的具體 URL 路徑，如 GET /api/users

Req

→

Auth

→

Log

→

Route

中介軟體

Middleware

請求到達路由前後執行的處理函式鏈

User.findOne({
 where:{id:5}
})

ORM

Object-Relational Mapping

以物件操作資料庫，省去直接撰寫 SQL

active deleted_at = null

deleted deleted_at = now

軟刪除

Soft Delete

不真正刪除資料，只標記 deleted_at 時間戳

DB 慢

→

Redis ⚡

快取

Cache

將計算結果暫存，加速重複讀取的速度

→

Worker

佇列

Queue

非同步任務排隊執行，避免阻塞主執行緒

系統

→ POST →

外部 URL

Webhook

事件觸發時主動推送 HTTP 請求至指定 URL

GET /api/urls
?limit=20
&offset=40

分頁

Pagination

大量資料分批讀取，避免一次傳輸過多

✓001_init.sql

✓002_add_tags.sql

→003_rbac.sql

資料遷移

Database Migration

資料庫結構版本管理，確保更新可重現

INSERT admin
password: admin123
(初始帳號)

Seed 資料

Seed Data

開發與測試用的初始化預設資料

INDEX(short_code)

查詢 O(log n)

索引

Index

提升資料庫查詢速度的輔助資料結構

DB_PASS=secret
JWT_SECRET=xxx
PORT=4002

環境變數

Environment Variables

不同部署環境的敏感設定，存於 .env 檔

Access-Control-
Allow-Origin:
https://myapp.com

CORS

CORS (Cross-Origin Resource Sharing)

控制跨來源請求的瀏覽器安全機制

200 OK

/health

健康檢查

Health Check

監控服務存活的 /health 端點

PUT × 3 次

= 同一結果

安全可重試

冪等性

Idempotency

相同請求重複執行不改變最終結果的特性

query {
 url(id:5){
  code clicks
 }
}

GraphQL

查詢語言，允許客戶端精確指定需要的資料欄位

100 req / 分鐘
超過回 429

速率限制

Rate Limiting

限制 API 請求頻率，防止濫用和 DDoS

舊 /api/v1/urls

新 /api/v2/urls

版本控制

API Versioning

支援舊 API 版本，同時提供新版本的設計方式