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)
}