124 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
		
		
			
		
	
	
			124 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
|  | syntax = "v1" | ||
|  | 
 | ||
|  | info ( | ||
|  | 	title:   "平台用户管理" | ||
|  | 	desc:    "平台用户管理" | ||
|  | 	author:  "Liangzai" | ||
|  | 	email:   "2440983361@qq.com" | ||
|  | 	version: "v1" | ||
|  | ) | ||
|  | 
 | ||
|  | // 平台用户管理接口 | ||
|  | @server( | ||
|  | 	prefix: /api/v1/admin/platform_user | ||
|  | 	group: admin_platform_user | ||
|  | 	jwt: JwtAuth | ||
|  | ) | ||
|  | 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"`        // 每页数量 | ||
|  | 		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         int64  `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 int64 `path:"id"` // 用户ID | ||
|  | 	} | ||
|  | 
 | ||
|  | 	// 详情响应 | ||
|  | 	AdminGetPlatformUserDetailResp { | ||
|  | 		Id         int64  `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 int64 `json:"id"` // 用户ID | ||
|  | 	} | ||
|  | 
 | ||
|  | 	// 更新请求 | ||
|  | 	AdminUpdatePlatformUserReq { | ||
|  | 		Id       int64   `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 int64 `path:"id"` // 用户ID | ||
|  | 	} | ||
|  | 
 | ||
|  | 	// 删除响应 | ||
|  | 	AdminDeletePlatformUserResp { | ||
|  | 		Success bool `json:"success"` // 是否成功 | ||
|  | 	} | ||
|  | ) |