• 課程大綱
• 課程簡報

RESTful API

Why RESTful API?

試想，在沒有任何經驗的情況下，請大家為我們的 final project digital notes 設計 API endpoints，大家會如何設計呢？

如果我們沒有設計規則，API 可能長這樣：

• POST /createNote
• GET /getNoteById
• POST /updateNote
• POST /deleteNote
• GET /searchNotes

這些 API 的問題是：

• 命名規則模糊、不統一 → frontend 和 backend 溝通成本變高
• 動作都混在 URL 裡

RESTful API 的目標是讓 API 命名更一致、更容易理解、更容易維護。

What is RESTful API?

Resource-Oriented Thinking

Resource 是系統中可以被操作的主要資料物件，例如在 Digital Note 中，核心 resources 是：users、notes 。

在Resource-Oriented Thinking中，我們思考的重點是「用戶端想要操作什麼資源」，以資源這個「名詞」為中心。