API: Improve Swagger annotations and update swagger.json

Signed-off-by: Michael Mayer <michael@photoprism.app>
This commit is contained in:
Michael Mayer
2025-10-30 11:47:40 +01:00
parent 5ea9f3bc4e
commit f2eebe2912
4 changed files with 6 additions and 6 deletions

View File

@@ -23,7 +23,7 @@ var swaggerJSON []byte
// //
// @Summary serves embedded Swagger documentation (debug builds only) // @Summary serves embedded Swagger documentation (debug builds only)
// @Id GetDocs // @Id GetDocs
// @Tags System // @Tags Debug
// @Produce json // @Produce json
// @Success 200 {object} gin.H "Swagger JSON" // @Success 200 {object} gin.H "Swagger JSON"
// @Router /swagger.json [get] // @Router /swagger.json [get]

View File

@@ -15,7 +15,7 @@ import (
// //
// @Summary allows members to submit a feedback message to the PhotoPrism team // @Summary allows members to submit a feedback message to the PhotoPrism team
// @Id SendFeedback // @Id SendFeedback
// @Tags Admin // @Tags Internal
// @Produce json // @Produce json
// @Success 200 {object} form.Feedback // @Success 200 {object} form.Feedback
// @Failure 400,401,403 {object} i18n.Response // @Failure 400,401,403 {object} i18n.Response

View File

@@ -15,7 +15,7 @@ import (
// //
// @Summary allows authorized admins to restart the server // @Summary allows authorized admins to restart the server
// @Id StopServer // @Id StopServer
// @Tags Admin // @Tags Internal
// @Produce json // @Produce json
// @Success 200 {object} config.Options // @Success 200 {object} config.Options
// @Failure 401,403 {object} i18n.Response // @Failure 401,403 {object} i18n.Response

View File

@@ -7568,7 +7568,7 @@
}, },
"summary": "allows members to submit a feedback message to the PhotoPrism team", "summary": "allows members to submit a feedback message to the PhotoPrism team",
"tags": [ "tags": [
"Admin" "Internal"
] ]
} }
}, },
@@ -10079,7 +10079,7 @@
}, },
"summary": "allows authorized admins to restart the server", "summary": "allows authorized admins to restart the server",
"tags": [ "tags": [
"Admin" "Internal"
] ]
} }
}, },
@@ -12674,7 +12674,7 @@
}, },
"summary": "serves embedded Swagger documentation (debug builds only)", "summary": "serves embedded Swagger documentation (debug builds only)",
"tags": [ "tags": [
"System" "Debug"
] ]
} }
}, },