您已經在 Apidog 中設計了一個完整的使用者 API。現在是時候將該設計轉化為可運作的程式碼了。這可能會讓您感到驚訝:您實際上不再需要從頭開始編寫所有內容。有了現今的 AI 工具,您可以在大約 30 分鐘內從您的設計規格生成一個完整的、生產就緒的 API。我知道這聽起來好得令人難以置信,但請繼續看下去。
開發方式的改變#
試想一下以前人們是如何建立 API 的。您需要花費數週時間學習程式語言,然後再花數週學習框架,最後才開始編寫程式碼。經過數小時的除錯後,您可能會得到一個勉強可用的東西。也許吧。如果您夠幸運的話。現在的情況已不再如此。在 2024 年,您 只需匯出您的 API 規格,將其提供給 AI 編碼助手,然後就能獲得一個包含身分驗證、資料庫整合、錯誤處理以及您所需一切的完整專案。然後,您將時間花在理解和自訂它上,而不是與語法錯誤搏鬥。
我們要建立什麼#
在本章中,您將建立一個完整的使用者 API,其中包含這些端點:POST /user/login - 使用 JWT token 登入
GET /users/{id} - 獲取使用者個人資料
PUT /users/{id} - 更新使用者(需驗證)
DELETE /users/{id} - 刪除帳戶(需驗證)
POST /user/logout - 登出(需驗證)
它將包含資料庫儲存(開發環境使用 SQLite,生產環境使用 PostgreSQL)、JWT 身分驗證、密碼雜湊、輸入驗證、適當的錯誤處理和安全性最佳實踐。最終結果是一個您實際上可以部署到線上並向人們展示的東西。這是一個真正的 API,而不是一個玩具專案。
工作流程#
1. 匯出您的 API 設計
在 Apidog 中,前往 Settings → Export → OpenAPI 3.0。您將獲得一個包含完整 API 設計的 openapi.json 檔案。2. 使用 AI 生成程式碼
在 Cursor 或 Windsurf 中打開該檔案,並要求它生成一個完整的專案。在大約 10 分鐘內,您將擁有完整的專案結構、所有實作的端點、配置好的資料庫以及可運作的身分驗證。您的 API 將在 http://localhost:8000 上執行。4. 在 Apidog 中測試
切換到您的「本地」環境,測試所有端點,並驗證回應是否符合您的設計。當我說它很快時,我是認真的。從匯出到部署 API 在一小時內完成是完全現實的。
您將使用的工具#
最佳的 AI 編碼體驗,具有適用於完整專案的 "Composer" 模式
Windsurf - codeium.com/windsurf(免費)如果您想在不付費的情況下開始,這是一個很好的替代方案
這些不僅僅是美化的自動完成工具。它們了解您的 API 規格,生成整個專案,解釋程式碼的作用,幫助除錯問題,並建議改進。這就像有一位經驗豐富的開發者與您結對程式設計。Python 3.10+
執行您的 API。安裝一次,使用簡單的指令。我們將在設定章節中介紹安裝。Railway 或 Render
提供 API 公開 URL 的免費部署平台。
準備好了嗎?#
確保您已完成「設計 API」章節,並在 Apidog 中設計好了您的 User 模組。這實際上就是您所需要的全部內容。接下來是安裝 Cursor 或 Windsurf 以及 Python,這大約需要 15 分鐘。然後,您將在 30 分鐘內生成您的第一個完整 API。 Modified at 2025-12-29 09:35:19