api

package
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 12, 2026 License: MIT Imports: 41 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ChangePassword

ChangePassword 添加修改密码的处理函数

func DeleteCategory

func DeleteCategory(req component.BetterRequest[struct {
	Id uint64 `json:"id"`
}]) component.Response

DeleteCategory 删除分类

func DeleteChat added in v0.1.1

DeleteChat 删除对话

func DeleteNotification

DeleteNotification 删除通知

func EditArticle

EditArticle 文章状态管理

func EditUserEmail

EditUserEmail 编辑用户

func EditUserInfo

EditUserInfo 编辑用户

func EditUsername

EditUsername 编辑用户

func ForgotPassword

ForgotPassword 忘记密码 - 发送重置邮件

func GetAnnouncement

func GetAnnouncement(req component.BetterRequest[null]) component.Response

GetAnnouncement 获取公告设置

func GetCategoryList

GetCategoryList 获取分类列表

func GetChatList added in v0.1.1

GetChatList 获取私信列表

func GetFileByFileName

func GetFileByFileName(c *gin.Context)
func GetFriendLinks(req component.BetterRequest[null]) component.Response

func GetLastUnread

GetLastUnread 获取未读通知数量

func GetMailSettings

func GetMailSettings(req component.BetterRequest[null]) component.Response

GetMailSettings 获取邮件设置

func GetMessages added in v0.1.1

GetMessages 获取消息记录

func GetNotificationList

GetNotificationList 获取通知列表

func GetNotificationTypes

GetNotificationTypes 获取所有通知类型

func GetPostingSettings added in v0.1.1

func GetPostingSettings(req component.BetterRequest[null]) component.Response

GetPostingSettings 获取发布内容设置

func GetSecuritySettings added in v0.1.1

func GetSecuritySettings(req component.BetterRequest[null]) component.Response

GetSecuritySettings 获取安全与注册设置

func GetSiteSettings

func GetSiteSettings(req component.BetterRequest[null]) component.Response

GetSiteSettings 获取站点设置

func GetSponsors

func GetSponsors(req component.BetterRequest[null]) component.Response

GetSponsors 获取赞助商配置

func GetSuggestedUsers added in v0.1.1

func GetSuggestedUsers(req component.BetterRequest[component.Null]) component.Response

GetSuggestedUsers 获取推荐用户(关注的人)

func GetTrafficOverview added in v0.1.1

func GetUnreadCount

GetUnreadCount 获取未读通知数量

func GetUserActivities added in v0.1.1

GetUserActivities 获取用户活动记录

func GetUserCard added in v0.1.1

func Invitation

func Invitation(req component.BetterRequest[null]) component.Response

func MarkAllAsRead

MarkAllAsRead 标记所有通知为已读

func MarkAsRead

MarkAsRead 标记通知为已读

func MarkChatRead added in v0.1.1

MarkChatRead 标记已读

func ResetPassword

ResetPassword 重置密码

func SaveAnnouncement

SaveAnnouncement 保存公告设置

func SaveCategory

SaveCategory 保存分类

SaveFriendLinks 保存友情链接

func SaveImgByGinContext

func SaveImgByGinContext(c *gin.Context)

SaveImgByGinContext 处理图片上传请求 包含文件大小限制、格式验证、内容检查等安全措施

func SaveMailSettings

SaveMailSettings 保存邮件设置

func SavePostingSettings added in v0.1.1

SavePostingSettings 保存发布内容设置

func SaveSecuritySettings added in v0.1.1

SaveSecuritySettings 保存安全与注册设置

func SaveSiteSettings

SaveSiteSettings 保存站点设置

func SaveSponsors

SaveSponsors 保存赞助商配置

func SaveUser

func SaveUser(userEntity *users.EntityComplete) error

func SendMessage added in v0.1.1

SendMessage 发送私信

func TestMailConnection

TestMailConnection 测试邮件连接

func UploadAvatar

func UploadAvatar(c *gin.Context)

UploadAvatar 头像上传处理函数

func UserInfo

func UserInfo(req component.BetterRequest[null]) component.Response

UserInfo 获取登录用户信息

Types

type ArticlesInfoAdminVo added in v0.1.1

type ArticlesInfoAdminVo struct {
	Id            uint64 `json:"id"`
	Title         string `json:"title"`
	Description   string `json:"description"`
	Type          int8   `json:"type"`   // 文章类型:0 博文,1教程,2问答,3分享
	UserId        uint64 `json:"userId"` //
	Username      string `json:"username"`
	UserAvatarUrl string `json:"userAvatarUrl"`
	ArticleStatus int8   `json:"articleStatus"` // 文章状态:0 草稿 1 发布
	ProcessStatus int8   `json:"processStatus"` // 管理状态:0 正常 1 封禁
	ViewCount     uint64 `json:"viewCount"`
	ReplyCount    uint64 `json:"replyCount"`
	LikeCount     uint64 `json:"likeCount"`
	CreatedAt     string `json:"createdAt"` // 改为 string 类型
	UpdatedAt     string `json:"updatedAt"` // 改为 string 类型
}

type ArticlesInfoVo added in v0.1.1

type ArticlesInfoVo struct {
	Id            uint64 `json:"id"`
	Title         string `json:"title"`
	Type          int8   `json:"type"`   // 文章类型:0 博文,1教程,2问答,3分享
	UserId        uint64 `json:"userId"` //
	Username      string `json:"username"`
	ArticleStatus int8   `json:"articleStatus"` // 文章状态:0 草稿 1 发布
	ProcessStatus int8   `json:"processStatus"` // 管理状态:0 正常 1 封禁
	CreatedAt     string `json:"createdAt"`     // 改为 string 类型
	UpdatedAt     string `json:"updatedAt"`     // 改为 string 类型
}

type ArticlesListReq

type ArticlesListReq struct {
	Page     int    `form:"page"`
	PageSize int    `form:"pageSize"`
	Search   string `form:"search"`
	UserId   uint64 `form:"userId"`
}

type CategoryItem

type CategoryItem struct {
	Id       uint64 `json:"id"`
	Category string `json:"category"`
	Desc     string `json:"desc"`
	Icon     string `json:"icon"`
	Color    string `json:"color"`
	Slug     string `json:"slug"`
	Sort     int    `json:"sort"`
	Status   int8   `json:"status"`
}

type CategoryListReq

type CategoryListReq struct {
	Page     int `json:"page"`
	PageSize int `json:"pageSize"`
}

type CategorySaveReq

type CategorySaveReq struct {
	Id       uint64 `json:"id"`
	Category string `json:"category" validate:"required"`
	Desc     string `json:"desc"`
	Icon     string `json:"icon"`
	Color    string `json:"color"`
	Slug     string `json:"slug"`
	Sort     int    `json:"sort"`
	Status   int8   `json:"status"`
}

type ChangePasswordReq

type ChangePasswordReq struct {
	OldPassword string `json:"oldPassword" validate:"required"`
	NewPassword string `json:"newPassword" validate:"required"`
}

ChangePasswordReq 添加新的请求结构体

type DailyTraffic added in v0.1.1

type DailyTraffic struct {
	Date         string `json:"date"`
	RegCount     int64  `json:"regCount"`
	ArticleCount int64  `json:"articleCount"`
	ReplyCount   int64  `json:"replyCount"`
}

type DeleteChatReq added in v0.1.1

type DeleteChatReq struct {
	ConvId uint64 `json:"convId" validate:"required"`
}

DeleteChatReq 删除对话请求

type DeleteNotificationReq

type DeleteNotificationReq struct {
	NotificationId uint64 `json:"notificationId" validate:"required"`
}

DeleteNotificationReq 删除通知请求

type EditArticleReq

type EditArticleReq struct {
	Id            uint64 `json:"id" validate:"required"`
	ProcessStatus int8   `json:"processStatus" validate:"oneof=0 1"` // 0正常 1封禁
}

type EditUserEmailReq

type EditUserEmailReq struct {
	Email string `json:"email" validate:"required,email"`
}

type EditUserInfoReq

type EditUserInfoReq struct {
	Nickname            string                    `json:"nickname"`
	Bio                 string                    `json:"bio"`
	Signature           string                    `json:"signature"`
	Website             string                    `json:"website"`
	WebsiteName         string                    `json:"websiteName"`
	ExternalInformation users.ExternalInformation `json:"externalInformation"`
}

type EditUserReq

type EditUserReq struct {
	UserId   uint64 `json:"userId"`
	Status   int8   `json:"status"`
	Validate int8   `json:"validate"`
	RoleId   uint64 `json:"roleId"`
}

type EditUsernameReq

type EditUsernameReq struct {
	Username string `json:"username" validate:"required"`
}

type ForgotPasswordReq

type ForgotPasswordReq struct {
	Email       string `json:"email" validate:"required,email"`
	CaptchaId   string `json:"captchaId" validate:"required"`
	CaptchaCode string `json:"captchaCode" validate:"required"`
}

ForgotPasswordReq 忘记密码请求结构体

type GetAllRoleItemReq

type GetAllRoleItemReq struct {
}

type GetChatListReq added in v0.1.1

type GetChatListReq struct {
}

GetChatListReq 获取私信列表请求

type GetMessagesReq added in v0.1.1

type GetMessagesReq struct {
	ConvId   uint64 `json:"convId" validate:"required"`
	Page     int    `json:"page" validate:"required,min=1"`
	PageSize int    `json:"pageSize" validate:"required,min=1,max=100"`
}

GetMessagesReq 获取消息记录请求

type GetNotificationListReq

type GetNotificationListReq struct {
	Page       int  `json:"page" validate:"required,min=1"`
	PageSize   int  `json:"pageSize" validate:"required,min=1,max=100"`
	UnreadOnly bool `json:"unreadOnly"`
}

GetNotificationListReq 获取通知列表请求

type GetNotificationTypesReq

type GetNotificationTypesReq struct{}

GetNotificationTypesReq 获取通知类型请求

type GetUnreadCountReq

type GetUnreadCountReq struct{}

GetUnreadCountReq 获取未读数量请求

type GetUserActivitiesReq added in v0.1.1

type GetUserActivitiesReq struct {
	UserId uint64 `form:"userId" validate:"required"`
	LastId uint64 `form:"lastId"`
	Limit  int    `form:"limit" validate:"max=50"`
}

type GetUserCardReq added in v0.1.1

type GetUserCardReq struct {
	UserId uint64 `form:"userId" json:"userId" binding:"required"`
}

type MarkAllAsReadReq

type MarkAllAsReadReq struct{}

MarkAllAsReadReq 标记所有通知已读请求

type MarkAsReadReq

type MarkAsReadReq struct {
	NotificationId uint64 `json:"notificationId" validate:"required"`
}

MarkAsReadReq 标记通知已读请求

type MarkReadReq added in v0.1.1

type MarkReadReq struct {
	ConvId uint64 `json:"convId" validate:"required"`
}

MarkReadReq 标记已读请求

type OptRecordPageReq

type OptRecordPageReq struct {
}

type PermissionItem

type PermissionItem struct {
	Id   uint64 `json:"id"`
	Name string `json:"name"`
}

type PermissionListReq

type PermissionListReq struct {
}

type QueryNotificationListReq

type QueryNotificationListReq struct {
	StartId    int  `json:"startId"`
	PageSize   int  `json:"pageSize" validate:"required,min=1,max=100"`
	UnreadOnly bool `json:"unreadOnly"`
}

QueryNotificationListReq 获取通知列表请求

type ResetPasswordReq

type ResetPasswordReq struct {
	Token       string `json:"token" validate:"required"`
	NewPassword string `json:"newPassword" validate:"required"`
}

ResetPasswordReq 重置密码请求结构体

type RoleItem

type RoleItem struct {
	RoleId      uint64           `json:"roleId"`
	RoleName    string           `json:"roleName"`
	Effective   int              `json:"effective"`
	Permissions []PermissionItem `json:"permissions"`
	CreateTime  string           `json:"createTime"`
}

type RoleListReq

type RoleListReq struct {
}

type RoleSaveDel

type RoleSaveDel struct {
	Id uint `json:"id"`
}

type RoleSaveReq

type RoleSaveReq struct {
	Id          uint     `json:"id"`
	RoleName    string   `json:"roleName" validate:"required"`
	Permissions []uint64 `json:"permissions" validate:"required,min=1,max=100"`
}

type SaveAnnouncementReq

type SaveAnnouncementReq struct {
	Settings pageConfig.AnnouncementConfig `json:"settings" validate:"required"`
}

type SaveFriendLinksReq

type SaveFriendLinksReq struct {
	LinksInfo []pageConfig.FriendLinksGroup `json:"linksInfo"`
}

type SaveMailSettingsReq

type SaveMailSettingsReq struct {
	Settings pageConfig.MailSettingsConfig `json:"settings" validate:"required"`
}

type SavePostingSettingsReq added in v0.1.1

type SavePostingSettingsReq struct {
	Settings pageConfig.PostingContent `json:"settings" validate:"required"`
}

type SaveSecuritySettingsReq added in v0.1.1

type SaveSecuritySettingsReq struct {
	Settings pageConfig.SecurityAndRegistration `json:"settings" validate:"required"`
}

type SaveSiteSettingsReq

type SaveSiteSettingsReq struct {
	Settings pageConfig.SiteSettingsConfig `json:"settings"`
}

type SaveSponsorsReq

type SaveSponsorsReq struct {
	SponsorsInfo pageConfig.SponsorsConfig `json:"sponsorsInfo"`
}

type SendMessageReq added in v0.1.1

type SendMessageReq struct {
	PeerId  uint64 `json:"peerId" validate:"required"`
	Content string `json:"content" validate:"required"`
	MsgType int8   `json:"msgType" validate:"oneof=1 2 3"` // 1: Text, 2: Image, 3: Voice
}

SendMessageReq 发送私信请求

type TestMailConnectionReq

type TestMailConnectionReq struct {
	Settings  pageConfig.MailSettingsConfig `json:"settings" validate:"required"`
	TestEmail string                        `json:"testEmail" validate:"required,email"`
}

type TestMailConnectionResp

type TestMailConnectionResp struct {
	Success bool   `json:"success"`
	Message string `json:"message"`
}

type TrafficOverviewReq added in v0.1.1

type TrafficOverviewReq struct {
	StartDate string `json:"startDate"` // YYYY-MM-DD
	EndDate   string `json:"endDate"`   // YYYY-MM-DD
}

type UserItem

type UserItem struct {
	UserId         uint64                              `json:"userId"`
	Username       string                              `json:"username"`
	AvatarUrl      string                              `json:"avatarUrl"`
	Email          string                              `json:"email"`
	Status         int8                                `json:"status"`
	Validate       int8                                `json:"validate"`
	Prestige       int64                               `json:"prestige"`
	RoleList       []datastruct.Option[string, uint64] `json:"roleList"`
	RoleId         uint64                              `json:"roleId,omitempty"`
	CreateTime     string                              `json:"createTime"`
	LastActiveTime string                              `json:"lastActiveTime"`
}

type UserListReq

type UserListReq struct {
	Username string `json:"username"`
	UserId   uint64 `json:"userId"`
	Email    string `json:"email"`
	Page     int    `json:"page"`
	PageSize int    `json:"pageSize"`
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL