user.api
//api 语法版本 syntax = "v1" info( author : "songmeizi" date : "2020-06-17" desc : "api语法示例及语法说明" ) //type literal type ( //发送给接口的信息 UserInfoReq { UserId int64 `json:"userId"` } //接口返回的信息 UserInfoResp { UserId int64 `json:"userId"` Name string `json:"name"` } ) type ( //发送给接口的信息 UserUpdateReq { UserId int64 `json:"userId"` Name string `json:"name"` } //接口返回的信息 UserUpdateResp { Flag bool `json:"flag"` } ) //权限和组用户定义 @server( // jwt: Auth group: user //文件实际地址分组 prefix : api //路由分组 ) service user-api{ @doc "获取用户信息" @handler userInfo post /user/info (UserInfoReq) returns (UserInfoResp) @doc "获取用户信息" @handler userUpdate post /user/Update (UserUpdateReq) returns (UserUpdateResp) }
编写好后再user.api同级目录下需运行此文件生成API接口
goctl api go -api user.api -dir .