Create API documentation with OpenAPI / Swagger

Define an OpenAPI specification for the main endpoints and mount a Swagger UI or Redoc viewer at a dedicated route. Keep models in sync with the actual response shapes and include example payloads for key operations.

首先，檢查程式碼庫中現有的 API 端點，以了解請求/回應的結構。使用 Swagger Editor 或 Redoc 等工具來起草 OpenAPI 規範，確保其與實際實作相符。然後，在專用路由（可能在伺服器設定或路由檔案中）整合一個檢視器（Swagger UI 或 Redoc）。透過執行應用程式並檢查文件路由來驗證。

由索引模型根據 Issue 內容生成。