f

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

@@ -0,0 +1,32 @@
+syntax = "v1"
+
+info (
+	title:   "工具箱服务"
+	desc:    "免费小工具：手机号归属地、VIN解析、车牌归属地等"
+	version: "v1"
+)
+
+// ==================== 通用请求/响应 ====================
+
+type (
+	ToolboxQueryReq {
+		ToolKey string                 `json:"tool_key" validate:"required"`
+		Params  map[string]interface{} `json:"params"`
+	}
+	ToolboxQueryResp {
+		ToolKey string                 `json:"tool_key"`
+		Result  map[string]interface{} `json:"result"`
+	}
+)
+
+// ==================== 免费接口（无需登录） ====================
+
+@server (
+	prefix: api/v1
+	group:  toolbox
+)
+service main {
+	@doc "通用工具查询"
+	@handler toolboxQuery
+	post /toolbox/query (ToolboxQueryReq) returns (ToolboxQueryResp)
+}