Files
TrangleAgent/Backend/api/user/v1/fans.go
2026-01-18 19:07:41 +08:00

81 lines
2.7 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package v1
import (
"TrangleAgent/internal/model/response"
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gtime"
)
// FansListItem 粉丝列表项
type FansListItem struct {
Id uint64 `json:"id" description:"自增主键"`
UserId uint64 `json:"userId" description:"用户ID被关注者本人"`
FanId uint64 `json:"fanId" description:"粉丝用户ID"`
Status int `json:"status" description:"状态1=粉丝 0=取关/无效"`
Remark string `json:"remark" description:"备注名user_id 对 fan_id 的备注/分组)"`
CreatedAt *gtime.Time `json:"createdAt" description:"创建时间"`
UpdatedAt *gtime.Time `json:"updatedAt" description:"更新时间"`
}
// FansListReq 粉丝列表请求参数
type FansListReq struct {
response.PageResult
g.Meta `path:"/fans/list" method:"get" tags:"粉丝" summary:"粉丝列表"`
UserId uint64 `json:"userId" v:"required#用户ID不能为空"`
Status int `json:"status" description:"状态1=粉丝 0=取关/无效"`
}
// FansListRes 粉丝列表响应参数
type FansListRes struct {
response.PageResult
List []*FansListItem `json:"list"`
}
// FansViewReq 粉丝详情请求参数
type FansViewReq struct {
g.Meta `path:"/fans/view" method:"get" tags:"粉丝" summary:"粉丝详情"`
Id uint64 `json:"id" v:"required#粉丝关系ID不能为空"`
}
// FansViewRes 粉丝详情响应参数
type FansViewRes struct {
FansListItem
}
// FansUpdateReq 粉丝更新请求参数
type FansUpdateReq struct {
g.Meta `path:"/fans/update" method:"put" tags:"粉丝" summary:"更新粉丝"`
Id uint64 `json:"id" v:"required#粉丝关系ID不能为空"`
Status int `json:"status" description:"状态1=粉丝 0=取关/无效"`
Remark string `json:"remark" description:"备注名user_id 对 fan_id 的备注/分组)"`
}
// FansUpdateRes 粉丝更新响应参数
type FansUpdateRes struct {
Id uint64 `json:"id"`
}
// FansDeleteReq 粉丝删除请求参数
type FansDeleteReq struct {
g.Meta `path:"/fans/delete" method:"delete" tags:"粉丝" summary:"删除粉丝"`
Id uint64 `json:"id" v:"required#粉丝关系ID不能为空"`
}
// FansDeleteRes 粉丝删除响应参数
type FansDeleteRes struct {
}
// FansCreateReq 粉丝创建请求参数
type FansCreateReq struct {
g.Meta `path:"/fans/create" method:"post" tags:"粉丝" summary:"创建粉丝"`
UserId uint64 `json:"userId" v:"required#用户ID不能为空"`
FanId uint64 `json:"fanId" v:"required#粉丝用户ID不能为空"`
Remark string `json:"remark" description:"备注名user_id 对 fan_id 的备注/分组)"`
}
// FansCreateRes 粉丝创建响应参数
type FansCreateRes struct {
Id uint64 `json:"id"`
}