docs: update api docs

Signed-off-by: hongming <talonwan@yunify.com>

tools/cmd/doc-gen/main.go

@@ -27,6 +27,7 @@ import (
 	"github.com/go-openapi/spec"
 	"io/ioutil"
 	"kubesphere.io/kubesphere/pkg/apiserver/runtime"
+	"kubesphere.io/kubesphere/pkg/constants"
 	"log"
 	// Install apis
 	_ "kubesphere.io/kubesphere/pkg/apis/devops/install"
@@ -62,6 +63,33 @@ func generateSwaggerJson() {
 
 	swagger := restfulspec.BuildSwagger(config)
 
+	swagger.Info.Extensions = make(spec.Extensions)
+	swagger.Info.Extensions.Add("x-tagGroups", []struct {
+		Name string   `json:"name"`
+		Tags []string `json:"tags"`
+	}{
+		{
+			Name: "IAM",
+			Tags: []string{constants.IdentityManagementTag, constants.AccessManagementTag},
+		},
+		{
+			Name: "Resources",
+			Tags: []string{constants.ClusterResourcesTag, constants.NamespaceResourcesTag, constants.UserResourcesTag},
+		},
+		{
+			Name: "Monitoring",
+			Tags: []string{constants.ComponentStatusTag},
+		},
+		{
+			Name: "Tenant",
+			Tags: []string{constants.TenantResourcesTag},
+		},
+		{
+			Name: "Other",
+			Tags: []string{constants.VerificationTag},
+		},
+	})
+
 	data, _ := json.Marshal(swagger)
 	err := ioutil.WriteFile(output, data, 420)
 	if err != nil {