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 .










