專題 C2：API 偵錯
如何快速 Mock OpenAPI
高品質 Mock 的關鍵不是快速回幾筆假資料，而是讓狀態碼、欄位結構與範例始終和規格同步。
快速 Mock 的正確順序
先確認目標 operation、請求參數與回應 schema 是否完整，再決定要產出哪些範例 payload。
如果一開始就直接手寫假資料、不理 schema，Mock 很快就會變成前後端都不信任的樣板。
讓 Mock 在迭代中持續可用
- 固定狀態碼與關鍵 header，避免同一路徑每次回傳不同語意。
- 把樣例資料做成可重播 fixture，而不是臨時拼 JSON。
- 規格變更核准後連同 Mock snapshot 一起更新，避免文件與示例脫鉤。
實用輸入/輸出範例
輸入
GET /users/{id}
response schema: User輸出
200 application/json
{"id":"u_123","name":"Ava","role":"admin"}