fix: Fix missing response types in Swagger API endpoints (#7611)

Refs #7607

backend/app/api/v1/app.go

@@ -13,7 +13,7 @@ import (
 // @Summary List apps
 // @Accept json
 // @Param request body request.AppSearch true "request"
-// @Success 200
+// @Success 200 {object} response.AppRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /apps/search [post]
@@ -183,7 +183,7 @@ func (b *BaseApi) GetAppTags(c *gin.Context) {
 
 // @Tags App
 // @Summary Get app list update
-// @Success 200
+// @Success 200 {object} response.AppUpdateRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /apps/checkupdate [get]

backend/app/api/v1/app_install.go

@@ -13,7 +13,7 @@ import (
 // @Summary Page app installed
 // @Accept json
 // @Param request body request.AppInstalledSearch true "request"
-// @Success 200
+// @Success 200 {object} dto.PageResult
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /apps/installed/search [post]
@@ -45,7 +45,7 @@ func (b *BaseApi) SearchAppInstalled(c *gin.Context) {
 // @Tags App
 // @Summary List app installed
 // @Accept json
-// @Success 200 array dto.AppInstallInfo
+// @Success 200 {array} dto.AppInstallInfo
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /apps/installed/list [get]
@@ -105,7 +105,7 @@ func (b *BaseApi) LoadPort(c *gin.Context) {
 // @Accept json
 // @Param request body dto.OperationWithNameAndType true "request"
 // @Param key path string true "key"
-// @Success 200 {string} response.DatabaseConn
+// @Success 200 {object} response.DatabaseConn
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /apps/installed/conninfo/{key} [get]
@@ -266,7 +266,7 @@ func (b *BaseApi) GetDefaultConfig(c *gin.Context) {
 // @Summary Search params by appInstallId
 // @Accept json
 // @Param appInstallId path string true "request"
-// @Success 200 {object} response.AppParam
+// @Success 200 {object} response.AppConfig
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /apps/installed/params/{appInstallId} [get]

backend/app/api/v1/auth.go

@@ -119,7 +119,7 @@ func (b *BaseApi) GetResponsePage(c *gin.Context) {
 
 // @Tags Auth
 // @Summary Check System isDemo
-// @Success 200
+// @Success 200 {boolean} isDemo
 // @Router /auth/demo [get]
 func (b *BaseApi) CheckIsDemo(c *gin.Context) {
 	helper.SuccessWithData(c, global.CONF.System.IsDemo)
@@ -127,7 +127,7 @@ func (b *BaseApi) CheckIsDemo(c *gin.Context) {
 
 // @Tags Auth
 // @Summary Check System isIntl
-// @Success 200
+// @Success 200 {boolean} isIntl
 // @Router /auth/intl [get]
 func (b *BaseApi) CheckIsIntl(c *gin.Context) {
 	helper.SuccessWithData(c, global.CONF.System.IsIntl)
@@ -135,7 +135,7 @@ func (b *BaseApi) CheckIsIntl(c *gin.Context) {
 
 // @Tags Auth
 // @Summary Load System Language
-// @Success 200
+// @Success 200 {string} language
 // @Router /auth/language [get]
 func (b *BaseApi) GetLanguage(c *gin.Context) {
 	settingInfo, err := settingService.GetSettingInfo()

backend/app/api/v1/backup.go

@@ -64,7 +64,7 @@ func (b *BaseApi) RefreshOneDriveToken(c *gin.Context) {
 // @Summary List buckets
 // @Accept json
 // @Param request body dto.ForBuckets true "request"
-// @Success 200 {array} string
+// @Success 200 {array} object
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/backup/search [post]
@@ -140,7 +140,7 @@ func (b *BaseApi) DeleteBackup(c *gin.Context) {
 // @Summary Page backup records
 // @Accept json
 // @Param request body dto.RecordSearch true "request"
-// @Success 200
+// @Success 200 {object} dto.PageResult
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/backup/record/search [post]
@@ -166,7 +166,7 @@ func (b *BaseApi) SearchBackupRecords(c *gin.Context) {
 // @Summary Page backup records by cronjob
 // @Accept json
 // @Param request body dto.RecordSearchByCronjob true "request"
-// @Success 200
+// @Success 200 {object} dto.PageResult
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/backup/record/search/bycronjob [post]
@@ -192,7 +192,7 @@ func (b *BaseApi) SearchBackupRecordsByCronjob(c *gin.Context) {
 // @Summary Download backup record
 // @Accept json
 // @Param request body dto.DownloadRecord true "request"
-// @Success 200
+// @Success 200 {string} filePath
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/backup/record/download [post]

backend/app/api/v1/clam.go

@@ -191,7 +191,7 @@ func (b *BaseApi) SearchClamRecord(c *gin.Context) {
 // @Summary Load clam record detail
 // @Accept json
 // @Param request body dto.ClamLogReq true "request"
-// @Success 200
+// @Success 200 {string} content
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /toolbox/clam/record/log [post]
@@ -214,7 +214,7 @@ func (b *BaseApi) LoadClamRecordLog(c *gin.Context) {
 // @Summary Load clam file
 // @Accept json
 // @Param request body dto.ClamFileReq true "request"
-// @Success 200 {object} dto.PageResult
+// @Success 200 {string} content
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /toolbox/clam/file/search [post]

backend/app/api/v1/container.go

@@ -41,7 +41,7 @@ func (b *BaseApi) SearchContainer(c *gin.Context) {
 // @Summary List containers
 // @Accept json
 // @Produce json
-// @Success 200
+// @Success 200 {array} string
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /containers/list [post]
@@ -83,7 +83,7 @@ func (b *BaseApi) SearchCompose(c *gin.Context) {
 // @Summary Test compose
 // @Accept json
 // @Param request body dto.ComposeCreate true "request"
-// @Success 200
+// @Success 200 {boolean} isOK
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /containers/compose/test [post]
@@ -106,7 +106,7 @@ func (b *BaseApi) TestCompose(c *gin.Context) {
 // @Summary Create compose
 // @Accept json
 // @Param request body dto.ComposeCreate true "request"
-// @Success 200
+// @Success 200 {string} log
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /containers/compose [post]
@@ -312,7 +312,7 @@ func (b *BaseApi) CleanContainerLog(c *gin.Context) {
 // @Summary Load container log
 // @Accept json
 // @Param request body dto.OperationWithNameAndType true "request"
-// @Success 200
+// @Success 200 {string} content
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /containers/load/log [post]

backend/app/api/v1/cronjob.go

@@ -92,7 +92,7 @@ func (b *BaseApi) SearchJobRecords(c *gin.Context) {
 // @Summary Load Cronjob record log
 // @Accept json
 // @Param request body dto.OperateByID true "request"
-// @Success 200
+// @Success 200 {string} content
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /cronjobs/records/log [post]

backend/app/api/v1/database.go

@@ -43,7 +43,7 @@ func (b *BaseApi) CreateDatabase(c *gin.Context) {
 // @Summary Check database
 // @Accept json
 // @Param request body dto.DatabaseCreate true "request"
-// @Success 200
+// @Success 200 {boolean} isOk
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /databases/db/check [post]

backend/app/api/v1/database_common.go

@@ -34,7 +34,7 @@ func (b *BaseApi) LoadDBBaseInfo(c *gin.Context) {
 // @Summary Load Database conf
 // @Accept json
 // @Param request body dto.OperationWithNameAndType true "request"
-// @Success 200
+// @Success 200 {string} content
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /databases/common/load/file [post]

backend/app/api/v1/device.go

@@ -46,7 +46,7 @@ func (b *BaseApi) LoadTimeOption(c *gin.Context) {
 // @Summary load conf
 // @Accept json
 // @Param request body dto.OperationWithName true "request"
-// @Success 200
+// @Success 200 {array} string
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /toolbox/device/conf [post]
@@ -185,7 +185,7 @@ func (b *BaseApi) UpdateDeviceSwap(c *gin.Context) {
 // @Summary Check device DNS conf
 // @Accept json
 // @Param request body dto.SettingUpdate true "request"
-// @Success 200
+// @Success 200 {boolean} data
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /toolbox/device/check/dns [post]
@@ -206,7 +206,7 @@ func (b *BaseApi) CheckDNS(c *gin.Context) {
 
 // @Tags Device
 // @Summary Scan system
-// @Success 200
+// @Success 200 {object} dto.CleanData
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /toolbox/scan [post]

backend/app/api/v1/fail2ban.go

@@ -118,7 +118,7 @@ func (b *BaseApi) UpdateFail2BanConf(c *gin.Context) {
 // @Tags Fail2ban
 // @Summary Load fail2ban conf
 // @Accept json
-// @Success 200
+// @Success 200 {string} file
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /toolbox/fail2ban/load/conf [get]

backend/app/api/v1/favorite.go

@@ -12,7 +12,7 @@ import (
 // @Summary List favorites
 // @Accept json
 // @Param request body dto.PageInfo true "request"
-// @Success 200
+// @Success 200 {object} dto.PageResult
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/favorite/search [post]
@@ -36,7 +36,7 @@ func (b *BaseApi) SearchFavorite(c *gin.Context) {
 // @Summary Create favorite
 // @Accept json
 // @Param request body request.FavoriteCreate true "request"
-// @Success 200
+// @Success 200 {object} model.Favorite
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/favorite [post]

backend/app/api/v1/file.go

@@ -39,19 +39,19 @@ func (b *BaseApi) ListFiles(c *gin.Context) {
 	if err := helper.CheckBindAndValidate(&req, c); err != nil {
 		return
 	}
-	files, err := fileService.GetFileList(req)
+	fileList, err := fileService.GetFileList(req)
 	if err != nil {
 		helper.ErrorWithDetail(c, constant.CodeErrInternalServer, constant.ErrTypeInternalServer, err)
 		return
 	}
-	helper.SuccessWithData(c, files)
+	helper.SuccessWithData(c, fileList)
 }
 
 // @Tags File
 // @Summary Page file
 // @Accept json
 // @Param request body request.SearchUploadWithPage true "request"
-// @Success 200 {array} response.FileInfo
+// @Success 200 {object} dto.PageResult
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/upload/search [post]
@@ -401,7 +401,7 @@ func (b *BaseApi) UploadFiles(c *gin.Context) {
 // @Summary Check file exist
 // @Accept json
 // @Param request body request.FilePathCheck true "request"
-// @Success 200
+// @Success 200 {boolean} isOk
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/check [post]
@@ -442,7 +442,7 @@ func (b *BaseApi) ChangeFileName(c *gin.Context) {
 // @Summary Wget file
 // @Accept json
 // @Param request body request.FileWget true "request"
-// @Success 200
+// @Success 200 {object} response.FileWgetRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/wget [post]
@@ -584,7 +584,7 @@ func (b *BaseApi) DownloadChunkFiles(c *gin.Context) {
 // @Summary Load file size
 // @Accept json
 // @Param request body request.DirSizeReq true "request"
-// @Success 200
+// @Success 200 {object} response.DirSizeRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/size [post]
@@ -786,7 +786,7 @@ func (b *BaseApi) Keys(c *gin.Context) {
 // @Tags File
 // @Summary Read file by Line
 // @Param request body request.FileReadByLineReq true "request"
-// @Success 200
+// @Success 200 {object} response.FileLineContent
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/read [post]

backend/app/api/v1/firewall.go

@@ -53,7 +53,7 @@ func (b *BaseApi) SearchFirewallRule(c *gin.Context) {
 // @Summary Page firewall status
 // @Accept json
 // @Param request body dto.FirewallOperation true "request"
-// @Success 200 {object} dto.PageResult
+// @Success 200
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /hosts/firewall/operate [post]

backend/app/api/v1/host.go

@@ -12,7 +12,7 @@ import (
 // @Summary Create host
 // @Accept json
 // @Param request body dto.HostOperate true "request"
-// @Success 200
+// @Success 200 {object} dto.HostInfo
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /hosts [post]
@@ -35,7 +35,7 @@ func (b *BaseApi) CreateHost(c *gin.Context) {
 // @Summary Test host conn by info
 // @Accept json
 // @Param request body dto.HostConnTest true "request"
-// @Success 200
+// @Success 200 {boolean} connStatus
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /hosts/test/byinfo [post]
@@ -95,7 +95,7 @@ func (b *BaseApi) HostTree(c *gin.Context) {
 // @Summary Page host
 // @Accept json
 // @Param request body dto.SearchHostWithPage true "request"
-// @Success 200 {array} dto.HostTree
+// @Success 200 {object} dto.PageResult
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /hosts/search [post]

backend/app/api/v1/host_tool.go

@@ -11,7 +11,7 @@ import (
 // @Summary Get tool status
 // @Accept json
 // @Param request body request.HostToolReq true "request"
-// @Success 200
+// @Success 200 {object} response.HostToolRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /host/tool [post]
@@ -77,7 +77,7 @@ func (b *BaseApi) OperateTool(c *gin.Context) {
 // @Summary Get tool config
 // @Accept json
 // @Param request body request.HostToolConfig true "request"
-// @Success 200
+// @Success 200 {object} response.HostToolConfig
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /host/tool/config [post]
@@ -100,7 +100,7 @@ func (b *BaseApi) OperateToolConfig(c *gin.Context) {
 // @Summary Get tool logs
 // @Accept json
 // @Param request body request.HostToolLogReq true "request"
-// @Success 200
+// @Success 200 {string} logContent
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /host/tool/log [post]
@@ -144,7 +144,7 @@ func (b *BaseApi) OperateProcess(c *gin.Context) {
 // @Tags Host tool
 // @Summary Get Supervisor process config
 // @Accept json
-// @Success 200
+// @Success 200 {object} response.SupervisorProcessConfig
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /host/tool/supervisor/process [get]
@@ -161,7 +161,7 @@ func (b *BaseApi) GetProcess(c *gin.Context) {
 // @Summary Get Supervisor process config
 // @Accept json
 // @Param request body request.SupervisorProcessFileReq true "request"
-// @Success 200
+// @Success 200 {string} content
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /host/tool/supervisor/process/file [post]

backend/app/api/v1/image.go

@@ -94,7 +94,7 @@ func (b *BaseApi) ImageBuild(c *gin.Context) {
 // @Summary Pull image
 // @Accept json
 // @Param request body dto.ImagePull true "request"
-// @Success 200 {string} log
+// @Success 200 {string} logPath
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /containers/image/pull [post]
@@ -118,7 +118,7 @@ func (b *BaseApi) ImagePull(c *gin.Context) {
 // @Summary Push image
 // @Accept json
 // @Param request body dto.ImagePush true "request"
-// @Success 200 {string} log
+// @Success 200 {string} logPath
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /containers/image/push [post]

backend/app/api/v1/logs.go

@@ -63,7 +63,7 @@ func (b *BaseApi) GetOperationLogs(c *gin.Context) {
 // @Summary Clean operation logs
 // @Accept json
 // @Param request body dto.CleanLog true "request"
-// @Success 200 {object} dto.PageResult
+// @Success 200
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /logs/clean [post]
@@ -84,7 +84,7 @@ func (b *BaseApi) CleanLogs(c *gin.Context) {
 
 // @Tags Logs
 // @Summary Load system log files
-// @Success 200
+// @Success 200 {array} string
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /logs/system/files [get]
@@ -100,7 +100,7 @@ func (b *BaseApi) GetSystemFiles(c *gin.Context) {
 
 // @Tags Logs
 // @Summary Load system logs
-// @Success 200
+// @Success 200 {string} data
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /logs/system [post]

backend/app/api/v1/monitor.go

@@ -18,7 +18,7 @@ import (
 // @Tags Monitor
 // @Summary Load monitor datas
 // @Param request body dto.MonitorSearch true "request"
-// @Success 200
+// @Success 200 {array} dto.MonitorData
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /hosts/monitor/search [post]

backend/app/api/v1/nginx.go

@@ -9,7 +9,7 @@ import (
 
 // @Tags OpenResty
 // @Summary Load OpenResty conf
-// @Success 200 {object} response.FileInfo
+// @Success 200 {object} response.NginxFile
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /openresty [get]

backend/app/api/v1/recycle_bin.go

@@ -12,7 +12,7 @@ import (
 // @Summary List Recycle Bin files
 // @Accept json
 // @Param request body dto.PageInfo true "request"
-// @Success 200
+// @Success 200 {object} dto.PageResult
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/recycle/search [post]
@@ -72,7 +72,7 @@ func (b *BaseApi) ClearRecycleBinFile(c *gin.Context) {
 // @Tags File
 // @Summary Get Recycle Bin status
 // @Accept json
-// @Success 200
+// @Success 200 {string} content
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /files/recycle/status [get]

backend/app/api/v1/runtime.go

@@ -12,7 +12,7 @@ import (
 // @Summary List runtimes
 // @Accept json
 // @Param request body request.RuntimeSearch true "request"
-// @Success 200
+// @Success 200 {object} dto.PageResult
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /runtimes/search [post]
@@ -36,7 +36,7 @@ func (b *BaseApi) SearchRuntimes(c *gin.Context) {
 // @Summary Create runtime
 // @Accept json
 // @Param request body request.RuntimeCreate true "request"
-// @Success 200
+// @Success 200 {object} model.Runtime
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /runtimes [post]
@@ -115,7 +115,7 @@ func (b *BaseApi) UpdateRuntime(c *gin.Context) {
 // @Summary Get runtime
 // @Accept json
 // @Param id path string true "request"
-// @Success 200
+// @Success 200 {object} response.RuntimeDTO
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /runtimes/{id} [get]
@@ -137,7 +137,7 @@ func (b *BaseApi) GetRuntime(c *gin.Context) {
 // @Summary Get Node package scripts
 // @Accept json
 // @Param request body request.NodePackageReq true "request"
-// @Success 200
+// @Success 200 {array} response.PackageScripts
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /runtimes/node/package [post]
@@ -180,7 +180,7 @@ func (b *BaseApi) OperateRuntime(c *gin.Context) {
 // @Summary Get Node modules
 // @Accept json
 // @Param request body request.NodeModuleReq true "request"
-// @Success 200
+// @Success 200 {array} response.NodeModule
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /runtimes/node/modules [post]

backend/app/api/v1/setting.go

@@ -160,7 +160,7 @@ func (b *BaseApi) UpdateSSL(c *gin.Context) {
 
 // @Tags System Setting
 // @Summary Load system cert info
-// @Success 200 {object} dto.SettingInfo
+// @Success 200 {object} dto.SSLInfo
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/ssl/info [get]
@@ -192,7 +192,7 @@ func (b *BaseApi) DownloadSSL(c *gin.Context) {
 // @Tags System Setting
 // @Summary Load system address
 // @Accept json
-// @Success 200
+// @Success 200 {array} string
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/interface [get]
@@ -346,7 +346,7 @@ func (b *BaseApi) MFABind(c *gin.Context) {
 // @Tags System Setting
 // @Summary Generate api key
 // @Accept json
-// @Success 200
+// @Success 200 {string} apiKey
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/api/config/generate/key [post]

backend/app/api/v1/snapshot.go

@@ -55,7 +55,7 @@ func (b *BaseApi) ImportSnapshot(c *gin.Context) {
 // @Summary Load Snapshot status
 // @Accept json
 // @Param request body dto.OperateByID true "request"
-// @Success 200
+// @Success 200 {object} dto.SnapshotStatus
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/snapshot/status [post]
@@ -124,7 +124,7 @@ func (b *BaseApi) SearchSnapshot(c *gin.Context) {
 // @Summary Load system snapshot size
 // @Accept json
 // @Param request body dto.PageSnapshot true "request"
-// @Success 200
+// @Success 200 {array} dto.SnapshotFile
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/snapshot/size [post]

backend/app/api/v1/ssh.go

@@ -114,7 +114,7 @@ func (b *BaseApi) GenerateSSH(c *gin.Context) {
 // @Summary Load host SSH secret
 // @Accept json
 // @Param request body dto.GenerateLoad true "request"
-// @Success 200
+// @Success 200 {string} data
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /host/ssh/secret [post]
@@ -156,7 +156,7 @@ func (b *BaseApi) LoadSSHLogs(c *gin.Context) {
 
 // @Tags SSH
 // @Summary Load host SSH conf
-// @Success 200
+// @Success 200 {string} data
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /host/ssh/conf [get]

backend/app/api/v1/upgrade.go

@@ -26,7 +26,7 @@ func (b *BaseApi) GetUpgradeInfo(c *gin.Context) {
 // @Summary Load release notes by version
 // @Accept json
 // @Param request body dto.Upgrade true "request"
-// @Success 200
+// @Success 200 {string} notes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /settings/upgrade [get]

backend/app/api/v1/website.go

@@ -51,7 +51,7 @@ func (b *BaseApi) GetWebsites(c *gin.Context) {
 
 // @Tags Website
 // @Summary List website names
-// @Success 200 {array} string
+// @Success 200 {array} response.WebsiteOption
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/options [get]
@@ -470,7 +470,7 @@ func (b *BaseApi) ChangePHPVersion(c *gin.Context) {
 // @Summary Get rewrite conf
 // @Accept json
 // @Param request body request.NginxRewriteReq true "request"
-// @Success 200
+// @Success 200 {object} response.NginxRewriteRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/rewrite [post]
@@ -554,7 +554,7 @@ func (b *BaseApi) UpdateSiteDirPermission(c *gin.Context) {
 // @Summary Get proxy conf
 // @Accept json
 // @Param request body request.WebsiteProxyReq true "request"
-// @Success 200
+// @Success 200 {array} request.WebsiteProxyConfig
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/proxies [post]
@@ -618,7 +618,7 @@ func (b *BaseApi) UpdateProxyConfigFile(c *gin.Context) {
 // @Summary Get AuthBasic conf
 // @Accept json
 // @Param request body request.NginxAuthReq true "request"
-// @Success 200
+// @Success 200 {object} response.NginxAuthRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/auths [post]
@@ -659,7 +659,7 @@ func (b *BaseApi) UpdateAuthConfig(c *gin.Context) {
 // @Summary Get AntiLeech conf
 // @Accept json
 // @Param request body request.NginxCommonReq true "request"
-// @Success 200
+// @Success 200 {object} response.NginxAntiLeechRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/leech [post]
@@ -722,7 +722,7 @@ func (b *BaseApi) UpdateRedirectConfig(c *gin.Context) {
 // @Summary Get redirect conf
 // @Accept json
 // @Param request body request.WebsiteProxyReq true "request"
-// @Success 200
+// @Success 200 {array} response.NginxRedirectConfig
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/redirect [post]
@@ -764,7 +764,7 @@ func (b *BaseApi) UpdateRedirectConfigFile(c *gin.Context) {
 // @Summary Get website dir
 // @Accept json
 // @Param request body request.WebsiteCommonReq true "request"
-// @Success 200
+// @Success 200 {object} response.WebsiteDirConfig
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/dir [post]
@@ -785,7 +785,7 @@ func (b *BaseApi) GetDirConfig(c *gin.Context) {
 // @Summary Get default html
 // @Accept json
 // @Param type path string true "type"
-// @Success 200 {object} response.FileInfo
+// @Success 200 {object} response.WebsiteHtmlRes
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/default/html/{type} [get]

backend/app/api/v1/website_domain.go

@@ -32,7 +32,7 @@ func (b *BaseApi) DeleteWebDomain(c *gin.Context) {
 // @Summary Create website domain
 // @Accept json
 // @Param request body request.WebsiteDomainCreate true "request"
-// @Success 200 {object} model.WebsiteDomain
+// @Success 200 {array} model.WebsiteDomain
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/domains [post]

backend/app/api/v1/website_ssl.go

@@ -17,7 +17,7 @@ import (
 // @Summary Page website ssl
 // @Accept json
 // @Param request body request.WebsiteSSLSearch true "request"
-// @Success 200
+// @Success 200 {array} response.WebsiteSSLDTO
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/ssl/search [post]
@@ -135,7 +135,7 @@ func (b *BaseApi) DeleteWebsiteSSL(c *gin.Context) {
 // @Summary Search website ssl by website id
 // @Accept json
 // @Param websiteId path integer true "request"
-// @Success 200
+// @Success 200 {object} response.WebsiteSSLDTO
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/ssl/website/{websiteId} [get]
@@ -157,7 +157,7 @@ func (b *BaseApi) GetWebsiteSSLByWebsiteId(c *gin.Context) {
 // @Summary Search website ssl by id
 // @Accept json
 // @Param id path integer true "request"
-// @Success 200
+// @Success 200 {object} response.WebsiteSSLDTO
 // @Security ApiKeyAuth
 // @Security Timestamp
 // @Router /websites/ssl/{id} [get]