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

82 lines
2.9 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"
)
// SubscribeListItem 关注列表项
type SubscribeListItem struct {
Id uint64 `json:"id" description:"自增主键"`
UserId uint64 `json:"userId" description:"用户ID关注者本人"`
FollowId uint64 `json:"followId" description:"被关注的用户ID"`
Status int `json:"status" description:"状态1=关注中 0=取消关注"`
Remark string `json:"remark" description:"备注名user_id 对 follow_id 的备注)"`
CreatedAt *gtime.Time `json:"createdAt" description:"创建时间"`
UpdatedAt *gtime.Time `json:"updatedAt" description:"更新时间"`
}
// SubscribeListReq 关注列表请求参数
type SubscribeListReq struct {
response.PageResult
g.Meta `path:"/subscribe/list" method:"get" tags:"关注" summary:"关注列表"`
UserId uint64 `json:"userId" v:"required#用户ID不能为空"`
Status int `json:"status" description:"状态1=关注中 0=取消关注"`
FollowId uint64 `json:"followId" description:"被关注的用户ID"`
}
// SubscribeListRes 关注列表响应参数
type SubscribeListRes struct {
response.PageResult
List []*SubscribeListItem `json:"list"`
}
// SubscribeViewReq 关注详情请求参数
type SubscribeViewReq struct {
g.Meta `path:"/subscribe/view" method:"get" tags:"关注" summary:"关注详情"`
Id uint64 `json:"id" v:"required#关注关系ID不能为空"`
}
// SubscribeViewRes 关注详情响应参数
type SubscribeViewRes struct {
SubscribeListItem
}
// SubscribeUpdateReq 关注更新请求参数
type SubscribeUpdateReq struct {
g.Meta `path:"/subscribe/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 对 follow_id 的备注)"`
}
// SubscribeUpdateRes 关注更新响应参数
type SubscribeUpdateRes struct {
Id uint64 `json:"id"`
}
// SubscribeDeleteReq 关注删除请求参数
type SubscribeDeleteReq struct {
g.Meta `path:"/subscribe/delete" method:"delete" tags:"关注" summary:"删除关注"`
Id uint64 `json:"id" v:"required#关注关系ID不能为空"`
}
// SubscribeDeleteRes 关注删除响应参数
type SubscribeDeleteRes struct {
}
// SubscribeCreateReq 关注创建请求参数
type SubscribeCreateReq struct {
g.Meta `path:"/subscribe/create" method:"post" tags:"关注" summary:"创建关注"`
UserId uint64 `json:"userId" v:"required#用户ID不能为空"`
FollowId uint64 `json:"followId" v:"required#被关注用户ID不能为空"`
Remark string `json:"remark" description:"备注名user_id 对 follow_id 的备注)"`
}
// SubscribeCreateRes 关注创建响应参数
type SubscribeCreateRes struct {
Id uint64 `json:"id"`
}