115 lines
3.9 KiB
Plaintext
115 lines
3.9 KiB
Plaintext
syntax = "v1"
|
||
|
||
info (
|
||
title: "平台用户管理"
|
||
desc: "平台用户管理"
|
||
version: "v1"
|
||
)
|
||
|
||
// 平台用户管理接口
|
||
@server (
|
||
prefix: /api/v1/admin/platform_user
|
||
group: admin_platform_user
|
||
middleware: AdminAuthInterceptor
|
||
)
|
||
service main {
|
||
// 创建平台用户
|
||
@handler AdminCreatePlatformUser
|
||
post /create (AdminCreatePlatformUserReq) returns (AdminCreatePlatformUserResp)
|
||
|
||
// 更新平台用户
|
||
@handler AdminUpdatePlatformUser
|
||
put /update/:id (AdminUpdatePlatformUserReq) returns (AdminUpdatePlatformUserResp)
|
||
|
||
// 删除平台用户
|
||
@handler AdminDeletePlatformUser
|
||
delete /delete/:id (AdminDeletePlatformUserReq) returns (AdminDeletePlatformUserResp)
|
||
|
||
// 获取平台用户分页列表
|
||
@handler AdminGetPlatformUserList
|
||
get /list (AdminGetPlatformUserListReq) returns (AdminGetPlatformUserListResp)
|
||
|
||
// 获取平台用户详情
|
||
@handler AdminGetPlatformUserDetail
|
||
get /detail/:id (AdminGetPlatformUserDetailReq) returns (AdminGetPlatformUserDetailResp)
|
||
}
|
||
|
||
type (
|
||
// 分页列表请求
|
||
AdminGetPlatformUserListReq {
|
||
Page int64 `form:"page,default=1"` // 页码
|
||
PageSize int64 `form:"pageSize,default=20"` // 每页数量
|
||
UserId string `form:"user_id,optional"` // 平台用户主键 ID，精确筛选
|
||
Mobile string `form:"mobile,optional"` // 手机号
|
||
Nickname string `form:"nickname,optional"` // 昵称
|
||
Inside int64 `form:"inside,optional"` // 是否内部用户 1-是 0-否
|
||
CreateTimeStart string `form:"create_time_start,optional"` // 创建时间开始
|
||
CreateTimeEnd string `form:"create_time_end,optional"` // 创建时间结束
|
||
OrderBy string `form:"order_by,optional"` // 排序字段
|
||
OrderType string `form:"order_type,optional"` // 排序类型
|
||
}
|
||
// 分页列表响应
|
||
AdminGetPlatformUserListResp {
|
||
Total int64 `json:"total"` // 总数
|
||
Items []PlatformUserListItem `json:"items"` // 列表
|
||
}
|
||
// 列表项
|
||
PlatformUserListItem {
|
||
Id string `json:"id"` // 用户ID
|
||
Mobile string `json:"mobile"` // 手机号
|
||
Nickname string `json:"nickname"` // 昵称
|
||
Info string `json:"info"` // 备注信息
|
||
Inside int64 `json:"inside"` // 是否内部用户 1-是 0-否
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
UpdateTime string `json:"update_time"` // 更新时间
|
||
}
|
||
// 详情请求
|
||
AdminGetPlatformUserDetailReq {
|
||
Id string `path:"id"` // 用户ID
|
||
}
|
||
// 详情响应
|
||
AdminGetPlatformUserDetailResp {
|
||
Id string `json:"id"` // 用户ID
|
||
Mobile string `json:"mobile"` // 手机号
|
||
Nickname string `json:"nickname"` // 昵称
|
||
Info string `json:"info"` // 备注信息
|
||
Inside int64 `json:"inside"` // 是否内部用户 1-是 0-否
|
||
CreateTime string `json:"create_time"` // 创建时间
|
||
UpdateTime string `json:"update_time"` // 更新时间
|
||
}
|
||
// 创建请求
|
||
AdminCreatePlatformUserReq {
|
||
Mobile string `json:"mobile"` // 手机号
|
||
Password string `json:"password"` // 密码
|
||
Nickname string `json:"nickname"` // 昵称
|
||
Info string `json:"info"` // 备注信息
|
||
Inside int64 `json:"inside"` // 是否内部用户 1-是 0-否
|
||
}
|
||
// 创建响应
|
||
AdminCreatePlatformUserResp {
|
||
Id string `json:"id"` // 用户ID
|
||
}
|
||
// 更新请求
|
||
AdminUpdatePlatformUserReq {
|
||
Id string `path:"id"` // 用户ID
|
||
Mobile *string `json:"mobile,optional"` // 手机号
|
||
Password *string `json:"password,optional"` // 密码
|
||
Nickname *string `json:"nickname,optional"` // 昵称
|
||
Info *string `json:"info,optional"` // 备注信息
|
||
Inside *int64 `json:"inside,optional"` // 是否内部用户 1-是 0-否
|
||
}
|
||
// 更新响应
|
||
AdminUpdatePlatformUserResp {
|
||
Success bool `json:"success"` // 是否成功
|
||
}
|
||
// 删除请求
|
||
AdminDeletePlatformUserReq {
|
||
Id string `path:"id"` // 用户ID
|
||
}
|
||
// 删除响应
|
||
AdminDeletePlatformUserResp {
|
||
Success bool `json:"success"` // 是否成功
|
||
}
|
||
)
|
||
|