syntax = "v1"

info (
	title:   "工具箱服务"
	desc:    "免费小工具：手机号归属地、VIN解析、车牌归属地等"
	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"`
	}
	ToolboxQueryResp {
		ToolKey string                 `json:"tool_key"`
		Result  map[string]interface{} `json:"result"`
	}
)

@server (
	prefix: api/v1
	group:  toolbox
)
service main {
	@doc "获取工具列表"
	@handler ToolboxList
	get /toolbox/list returns (ToolboxListResp)

	@doc "通用工具查询"
	@handler ToolboxQuery
	post /toolbox/query (ToolboxQueryReq) returns (ToolboxQueryResp)
}