API: Extract OpenAPI specification from source code using go-swagger (#40528) (#45061)

* API: Using go-swagger for extracting OpenAPI specification from source code

* Merge Grafana Alerting spec

* Include enterprise endpoints (if enabled)

* Serve SwaggerUI under feature flag

* Fix building dev docker images

* Configure swaggerUI

* Add missing json tags

Co-authored-by: Ying WANG <ying.wang@grafana.com>
Co-authored-by: Marcus Efraimsson <marcus.efraimsson@gmail.com>
(cherry picked from commit 35fe58de37)

pkg/api/dtos/acl.go

@@ -2,13 +2,21 @@ package dtos
 
 import "github.com/grafana/grafana/pkg/models"
 
+// swagger:model
 type UpdateDashboardAclCommand struct {
 	Items []DashboardAclUpdateItem `json:"items"`
 }
 
+// swagger:model
 type DashboardAclUpdateItem struct {
-	UserID     int64                 `json:"userId"`
-	TeamID     int64                 `json:"teamId"`
-	Role       *models.RoleType      `json:"role,omitempty"`
+	UserID int64            `json:"userId"`
+	TeamID int64            `json:"teamId"`
+	Role   *models.RoleType `json:"role,omitempty"`
+	// Permission level
+	// Description:
+	// * `1` - View
+	// * `2` - Edit
+	// * `4` - Admin
+	// Enum: 1,2,4
 	Permission models.PermissionType `json:"permission"`
 }