82b1ad2b5c
- api/common/v1 → api/open/v1，路由前缀 /api/common/v1 → /api/open/v1
- 契约层按子功能拆目录：api/open/v1/tools/{uuid,md5,random,time,ip}/index.go
- 控制器同步拆文件：internal/controller/open/{uuid,md5,random,time,ip}.go
- 命名规则（open 优于 common）与 tools 目录规则记入 AGENTS.md
- 冒烟测试：旧路由 404，新路由 5 端点全部通过
17 lines
546 B
Go
17 lines
546 B
Go
// Package random defines the GET /tools/random endpoint contract.
|
|
package random
|
|
|
|
import "github.com/gogf/gf/v2/frame/g"
|
|
|
|
// RandomReq generates a random string.
|
|
type RandomReq struct {
|
|
g.Meta `path:"/tools/random" method:"get" tags:"Open/Tools" summary:"Generate a random string"`
|
|
Length int `json:"length" d:"16" v:"min:1|max:128#length must be 1-128"`
|
|
Type string `json:"type" d:"alnum" v:"in:alnum,digits,letters#unsupported type"`
|
|
}
|
|
|
|
// RandomRes is the response of RandomReq.
|
|
type RandomRes struct {
|
|
Value string `json:"value"`
|
|
}
|