這是 Django Ninja 系列教學的第 8 篇。
上一篇文章中，我們介紹了 Django 傳統的路由設定方式。
如前所述，雖然有一個「路由清單」確實不錯。但隨著專案規模的擴大，不斷來回切換urls.py和views.py將大幅增加開發者的認知負擔——拉長了開發時間，還更容易導致錯誤。
Django Ninja 採用了一種更現代化的路由設計，結合了 Flask 和 FastAPI 的設計理念。不僅簡化了路由的定義，還提升了程式碼的可讀性，讓路由與 view 函式緊密結合。
本文關於路由設定的程式碼改動，可以參考這個 PR（Pull Request）。
範例專案合併了本文的 PR 後，已經正式成為一個「API 專案」，不過它目前（指這個 commit 狀態）尚無法正常運作，因為我們還沒有完善 view 函式的基本功能。
你可以一步步地跟著每一篇的 PR，來學習當次的新內容。這也是我為文章建立 PR 的用意所在。
這是 Django Ninja 系列教學的第 7 篇。我們來到系列的第三章。
第三章是全系列的重頭戲，因為我們要介紹 Django Ninja 的核心部分——API。
我把本章分成了三個小節：
第三章也是唯一有區分小節的篇章。
現在我們進入第一節——路由。讓我們先了解一下本節的學習重點。
👉 完整系列目錄：點此查看
👉 程式碼範例：GitHub 範例專案
本節一共有兩篇，分別是：
為什麼要這樣安排呢？因為端點與路由是 API 請求的起點。
沒有它們，你的 view 函式根本無法接收請求，更不用說回應了。因此，路由設定必須放在第一位，作為 API 開發的學習入口。
所謂的「端點」（endpoints），你就簡單想成 API 所在的 URL 就可以了。
其次，Django Ninja 的路由設定與傳統 Django 或 Django REST framework（以下簡稱 DRF）的路由設定有很大的不同，反而更接近 FastAPI 或 Flask 風格。
這是我在學習 Django Ninja 時遇到的第一個門檻（畢竟我寫了 2 年的 DRF😅），所以決定分成上下兩篇文章詳細解說，幫助你打好基礎、減少混淆。
本文的重點是介紹 Django 傳統路由的設定方式。讓我們開始吧！
這是 Django Ninja 系列教學的第 6 篇。
前一篇我們了解了整個專案所使用的 Python 開發工具。
本文將帶領你一步步完成，有關範例專案的環境設定：從安裝 Python、Poetry、clone 專案至本地、建立 Python 虛擬環境，到成功啟動 Django。
即使你從未接觸過這些工具，按著本文的指南，應該也能順利完成環境設定並運行。
值得一提的是，我已經使用 Mac 很長一段時間，對 Windows 環境不甚熟悉，但我會盡可能提供相關的替代方案或指引。
好，我們開始吧！
這是 Django Ninja 系列教學的第 5 篇。
在現代軟體開發中，工具不僅能提高開發效率，還能改善程式碼品質，讓專案的管理與維護變得更加輕鬆。
本文將介紹幾個重要的 Python 開發工具，討論它們在專案中的應用，讓讀者快速了解它們的定位與價值。
如果你看過我的部落格，應該會發現，我花了不少篇幅在大力推廣這些現代開發工具，為它們撰寫了一篇又一篇的詳細文章教學。
因此，我們不會深入這些工具的操作細節，而是著眼於概念，以及它們如何解決開發中的痛點。我會附上相關教學文章的連結，讓有興趣的讀者可以進一步學習。
值得一提的是，這些 Python 的現代開發實踐，都是我看了開發者 Wei Lee（李唯）的「Python Table Manners」系列後，才一一學習並落實的。個人強力推薦此系列！
這是 Django Ninja 系列教學的第 4 篇。
在第一章中，我們對 Django Ninja 做了全方位的介紹，並且分析了它與 Django REST framework 的主要區別。
相信你對 Django Ninja 已有了一定的了解。
接下來，我們將進入第二章：專案介紹與設定。
我們將透過一個 CRUD API 範例專案，幫助你在實踐中運用 Django Ninja 的概念。
本章將對專案概念進行介紹，包括模型設計與現實世界中的對應。（卷 4）
接著介紹專案使用的 Python 開發工具（卷 5）。最後會手把手帶你，安裝專案到本機並確保它正常運行（卷 6）。
其餘有關 API 的程式碼，將在第三章陸續介紹與實作。
這是 Django Ninja 系列教學的第 3 篇。
選擇任何工具之前，我們通常會先了解它能解決的問題，以及是否符合與自己的需求。
本文將介紹 Django Ninja 這個現代化的 API 框架，探討它的起源和主要特點，並重點比較它與 Django REST framework 之間的差異，讓你能夠更好地選擇適合的工具。
👉 完整系列目錄：點此查看
👉 程式碼範例：GitHub 範例專案
Django Ninja 的起源與 FastAPI 有著密切的關係。
Django Ninja 可以被視為「Django 版的 FastAPI」，它比原生 FastAPI 能夠更好地與 Django 整合。
Django Ninja 的官方文件中，作者 Vitaliy Kucheryaviy 解釋了為什麼建立這個框架。這源於他在 Django 專案中使用 FastAPI 時遇到的一些挑戰，特別是在整合方面。
因此，他決定自己建立一個更合適的工具，從而誕生了 Django Ninja。
可想而知，Django Ninja 深受 FastAPI 的啟發。事實上，它同時也借鑑了不少 Django REST framework 的優秀實踐——這是後發者的優勢！
文件中引用了這麼一句話，這是個常見的疑問：
Django Ninja looks basically the same as FastAPI, so why not just use FastAPI?
答案是：Django 與 FastAPI 兩者的整合不完美，而 Django Ninja 提供了一個更加適合 Django 開發者的版本。
這是 Django Ninja 系列教學的第 2 篇。
上一篇中，我們講述了系列的整體方向。現在，我將進一步深入，為你詳細介紹系列的架構與各個章節安排。
可以說，本文就是整個系列的藍圖。
一般而言，架構介紹通常會直接放在第一篇的後半段（如果有的話），但我決定獨立成一篇。
原因無他，我在整個教學架構上花費了相當的心思，希望為讀者提供一個全面的概覽。這有助於你快速進入狀況，並了解自己目前正在學習主題哪一個部分。
話不說多，讓我們一一介紹。