addf

app/main/api/desc/front/toolbox.api

@@ -6,9 +6,15 @@ info (
 	version: "v1"
 )
 
-// ==================== 通用请求/响应 ====================
-
 type (
+	ToolInfo {
+		Key  string `json:"key"` // 工具标识
+		Name string `json:"name"` // 工具名称
+		Desc string `json:"desc"` // 工具描述
+	}
+	ToolboxListResp {
+		Tools []ToolInfo `json:"tools"` // 工具列表
+	}
 	ToolboxQueryReq {
 		ToolKey string                 `json:"tool_key" validate:"required"`
 		Params  map[string]interface{} `json:"params"`
@@ -19,14 +25,16 @@ type (
 	}
 )
 
-// ==================== 免费接口（无需登录） ====================
-
 @server (
 	prefix: api/v1
 	group:  toolbox
 )
 service main {
+	@doc "获取工具列表"
+	@handler ToolboxList
+	get /toolbox/list returns (ToolboxListResp)
+
 	@doc "通用工具查询"
-	@handler toolboxQuery
+	@handler ToolboxQuery
 	post /toolbox/query (ToolboxQueryReq) returns (ToolboxQueryResp)
 }