帶有 Swagger 的 Django Rest 框架

從這篇文章可以期待什麼？

本文將介紹在 Django Rest 框架專案中實作 Swagger；我們將致力於我們的帳戶管理

系列訂購

有興趣可以查看之前的文章！

1. 從頭開始的人工智慧專案、創意、Alive 日記
2. 用 Google AI Studio 證明它是可行的
3. Django API 專案設定
4. Django帳戶管理（一）、註冊與啟動
5. Django帳戶管理（二）、登入及修改密碼
6. Swagger 與 Django Rest 框架（你在這裡？）

安裝和設定

我為rest-framework找到的最好的swagger產生器是drf-yasg，但如果你知道更好的，我願意接受建議！
讓我們從包裝安裝開始

現在轉到我們的設定檔

alive_diary/settings.py

我們已將 drf_yasg 應用程式新增至已安裝的應用程式中，並將預設驗證方法設為 Bearer JWT 令牌。

現在到 URL 檔案

就是這樣！幹得好！
我們來試試吧

開 http://localhost:8555/swagger/ 應該看起來像

使用自訂 ApiView 測試 Swagger

讓我們先使用 swagger 中的登入 API 視圖登入

然後，我們使用 swagger 頁面頂部的「授權」按鈕進行身份驗證。確保使用存取令牌，並且不要忘記它前面的 Bearer：“Bearer token...”

讓我們嘗試使用 Swagger 來變更密碼

它是空的！ swagger 無法辨識請求模式，最簡單的方法是使用 swagger auto schema

現在看起來不錯

我們現在可以使用 Swagger 測試所有經過驗證的請求！下一篇文章將回到帳號應用

敬請期待？

以上是帶有 Swagger 的 Django Rest 框架的詳細內容。更多資訊請關注PHP中文網其他相關文章！