OneAuth/oa/protoc/api/app.api

import "base.api"

type (
	// 定义登录接口的请求体
	AppReq {
		appname  string `form:"username"`
		Password string `json:"password"`
		Pa       string `path:"pa"`
	}
	// 定义登录接口的响应体
	AppResp {
		Id       int64  `json:"id"`
		Name     string `json:"name"`
		Token    string `json:"token"`
		ExpireAt string `json:"expireAt"`
	}
)

@server (
	// 代表当前 service 代码块下的路由生成代码时都会被放到 app 目录下
	group: app
	// 定义路由前缀为 "/v1"
	prefix: /api/app
)
// 定义 HTTP 服务
// 微服务名称为 main，生成的代码目录和配置文件将和 user 值相关
service main {
	// 定义 http.HandleFunc 转换的 go 文件名称及方法
	@handler Login
	// 定义接口
	// 请求方法为 post
	// 路由为 /app/login
	// 请求体为 LoginReq
	// 响应体为 LoginResp，响应体必须有 returns 关键字修饰
	get /login/:pa (AppReq) returns (AppResp)
}