API Academy
🌐 繁體中文
  • 🌐 English
  • 🌐 繁體中文
HomePetstore APIExplore more APIs
HomePetstore APIExplore more APIs
🌐 繁體中文
  • 🌐 English
  • 🌐 繁體中文
🌐 繁體中文
  • 🌐 English
  • 🌐 繁體中文
  1. Developing APIs
  • 歡迎
  • 目錄
  • API 學院
    • Get Started
      • 什麼是 API?
      • API 如何運作?
      • 如何呼叫 API?
      • 如何閱讀 API 文件?
      • 章節總結
    • API Fundamentals
      • API 基礎知識:概覽
      • 方法與路徑
      • 參數
      • 請求 Body
      • 回應
      • API 規格與 OAS
      • 章節總結
    • Working with APIs
      • 使用 API:概覽
      • 根據規格發送請求
      • 環境與變數
      • 串聯多個端點
      • 處理 Auth
      • 處理 API 簽名
      • 腳本介紹
      • 章節總結
    • Mocking APIs
      • Mocking API:概覽
      • Smart Mock
      • Mock 預期結果
      • Cloud Mock
      • Mock 腳本
      • 章節總結
    • Designing APIs
      • 設計 API:概覽
      • API 設計介紹
      • 建立您的第一個 API 專案
      • 分析需求並規劃您的 API
      • 設計資料模型
      • 設計端點
      • 使用組件與可重用性
      • 設定與 Auth
      • API 設計指南
      • 章節總結
    • Developing APIs
      • 開發 API:概覽
      • 設定:安裝您的 AI 程式碼助手
      • 快速入門:30 分鐘內從規格到運行的 API
      • 了解生成的程式碼
      • 使用 Apidog 測試您的 API
      • 部署:將您的 API 上線
      • 章節總結
    • Testing APIs
      • 測試 API:概覽
      • 快速入門:您的第一個測試場景
      • 整合測試與資料傳遞
      • 動態值
      • 斷言與驗證
      • 流程控制:If, For, ForEach
      • 資料驅動測試
      • 性能測試
      • 測試報告與分析
      • CI/CD 整合
      • 排程任務與自動化
      • 進階測試策略
      • 章節總結
    • API Documentations
      • API 文件:概覽
      • 發布您的第一個 API 文件
      • 自訂文件外觀
      • 給消費者的互動功能
      • 進階發布設定
      • 管理 API 版本
      • 章節總結
    • Advanced API Technologies
      • 進階 API 技術:概覽
      • GraphQL
      • gRPC
      • WebSocket
      • Socket.IO
      • Server-Sent Events
      • SOAP
      • 章節總結
    • API Lifecycle
      • API 生命周期:概覽
      • API 生命周期的階段
      • API 治理
      • API 安全最佳實踐
      • 監控與分析
      • API 版本策略
      • API 的未來
      • 章節總結
    • API Security
      • API 安全性:概覽
      • API 安全性基礎知識
      • 身份驗證 vs. 授權
      • 了解 OAuth 2.0 和 OpenID Connect
      • JSON Web Tokens (JWT)
      • OWASP API 安全 Top 10
      • 加密與 HTTPS
      • 章節總結
    • API Tools
      • API 工具:概覽
      • API 工具的演變
      • API Clients
      • 命令列工具 (cURL, HTTPie)
      • API 設計和文件工具
      • API Mocking 工具
      • API 測試工具
      • 一體化 API 平台
      • 章節總結
    • API Gateway
      • API Gateway:概覽
      • 什麼是 API Gateway?
      • API Gateway 的關鍵功能
      • API Gateway vs 負載平衡器 vs 服務網格
      • 流行 API Gateway 解決方案
      • BFF (Backend for Frontend) 模式
      • 章節總結
HomePetstore APIExplore more APIs
HomePetstore APIExplore more APIs
🌐 繁體中文
  • 🌐 English
  • 🌐 繁體中文
🌐 繁體中文
  • 🌐 English
  • 🌐 繁體中文
  1. Developing APIs

章節總結

您從 Apidog 中的 API 設計開始了本章。現在您擁有一個在生產環境中執行的全功能 API,可從網際網路上的任何地方訪問。
讓我們回顧一下您完成了什麼。

您構建了什麼#

一個完整的使用者 API,具有六個可運作的端點,已部署到生產環境:
帶有密碼雜湊的使用者註冊
帶有 JWT token 生成的登入
使用者個人資料檢索
帶有身分驗證的帳戶更新
帳戶刪除
登出功能
API 包含:
具有適當 schema 的 PostgreSQL 資料庫
基於 JWT 的身分驗證
使用 Pydantic 的輸入驗證
適當的錯誤處理和狀態碼
CORS 配置
基於環境的配置
在 Railway 上的生產部署
這不是一個教學專案。這是一個真實的 API,擁有您可以分享並在其基礎上構建的公開 URL。

您學到的工作流程#

設計 → 生成 → 理解 → 測試 → 部署
您從 Apidog 中的 API 規格開始。Cursor 的 AI 生成了完整的 FastAPI 實作。您通過閱讀檔案並詢問 AI 解釋概念來了解程式碼如何運作。Apidog 的 AI 自動生成了全面的測試案例。Railway 用一個指令部署了所有內容。
這就是現代 API 開發:AI 處理重複的實作,您專注於設計、理解和自訂。

您開發的技能#

AI 輔助開發:
您學會了使用 Cursor 從規格生成程式碼,要求 AI 解釋實作,並利用 AI 解決問題。此工作流程適用於任何開發專案。
API 基礎:
您了解 REST 原則、HTTP 方法、狀態碼、身分驗證模式和請求/回應週期——不僅在理論上,而且在可運作的程式碼中。
現代 Python 堆疊:
FastAPI, SQLAlchemy, Pydantic, JWT 身分驗證。您已經使用了當前的工具並看到了它們如何組合在一起。
測試和部署:
您知道如何用 AI 生成測試套件,跨環境執行它們,部署到生產平台,並管理環境變數。

這是真實的#

您擁有:
一個已部署的 API,帶有全天候運作的真實 URL
可運作的程式碼,您理解並可以修改
自動化測試,驗證正確性
生產經驗,使用真實的部署平台
您可以將此加入到您的作品集中。您可以在面試中展示它。您可以將其用於實際專案。

下一步是什麼#

您有一個部署到生產環境的可運作 API。但隨著您新增功能,如何確保它保持可靠?如何記錄它以便其他人可以有效地使用它?
接下來的章節涵蓋:
API 測試:進階測試策略、測試自動化以及確保 API 可靠性
發布 API 文件:建立專業的文件,幫助他人使用您的 API
您的 API 已上線,但開發工作流程仍在繼續。
繼續閱讀 → 測試 API:概覽
讓我們確保您的 API 經過徹底測試且文件齊全。
Modified at 2025-12-29 09:35:19
Previous
部署:將您的 API 上線
Next
測試 API:概覽
Built with