Add Swagger API documentation for ATSFlare Server with detailed endpoint definitions and models

atsf_server/router/main.go

@@ -1,11 +1,24 @@
 package router
 
 import (
+	"atsflare/middleware"
 	"embed"
+
 	"github.com/gin-gonic/gin"
+	swaggerFiles "github.com/swaggo/files"
+	ginSwagger "github.com/swaggo/gin-swagger"
 )
 
 func SetRouter(router *gin.Engine, buildFS embed.FS, indexPage []byte) {
 	SetApiRouter(router)
+	swaggerRoute := router.Group("/swagger")
+	swaggerRoute.Use(middleware.AdminAuth())
+	swaggerRoute.GET("/*any", ginSwagger.WrapHandler(
+		swaggerFiles.Handler,
+		ginSwagger.URL("/swagger/doc.json"),
+		ginSwagger.DocExpansion("list"),
+		ginSwagger.PersistAuthorization(true),
+		ginSwagger.DefaultModelsExpandDepth(1),
+	))
 	setWebRouter(router, buildFS, indexPage)
 }