API: Add Swagger annotations #2132

This commit is contained in:
graciousgrey
2024-09-03 16:47:29 +02:00
parent d6482815ae
commit 7792abf9a8
7 changed files with 486 additions and 27 deletions

View File

@@ -14,7 +14,17 @@ import (
// SearchLabels finds and returns labels as JSON.
//
// GET /api/v1/labels
// @Summary finds and returns labels as JSON
// @Id SearchLabels
// @Tags Labels
// @Produce json
// @Success 200 {object} search.Label
// @Failure 401,429,403,400 {object} i18n.Response
// @Param count query int true "maximum number of results" minimum(1) maximum(100000)
// @Param offset query int false "search result offset" minimum(0) maximum(100000)
// @Param all query bool false "show all"
// @Param q query string false "search query"
// @Router /api/v1/labels [get]
func SearchLabels(router *gin.RouterGroup) {
router.GET("/labels", func(c *gin.Context) {
s := Auth(c, acl.ResourceLabels, acl.ActionSearch)