comment.api 2.5 KB
syntax = "v1"

info(
	title: "评论相关"
	desc: "编辑处理文章的评论"
	author: "author"
	email: "email"
	version: "v1"
)

// 小程序接口
@server(
	prefix: v1/mini
	group: comment
	jwt: MiniAuth
)
service Core {

	@doc "小程序获取回复@人可选列表"
	@handler MiniArticleCommentAtUser
	post /article_comment/at_user/select (MiniArticleCommentAtUserRequest) returns (MiniArticleCommentAtUserResponse)

	@doc "小程序填写文章的评论"
	@handler MiniCreateArticleComment
	post /article_comment (MiniCreateArticleCommentRequest) returns (MiniCreateArticleCommentResponse)
}

//
// 小程序获取回复@人可选列表
type (
	MiniArticleCommentAtUserRequest {
		ArtitceId int64 `json:"articleId"`
	}

	MiniArticleCommentAtUserResponse {
	}
)

//评论的填写人
type CommentAuthor {
	Id       int64  `json:"id"`       // 人员id
	Name     string `json:"name"`     // 人员的名字
	Avatar   string `json:"avatar"`   // 人员头像URL
	Position string `json:"position"` // 职位
	Company  string `json:"company"`  // 公司
}

// 小程序填写文章的评论
type (
	MiniCreateArticleCommentRequest {
		ArtitceId  int64   `json:"articleId"` // 文章id
		SectionId  int64   `json:"sectionId"` // 段落id
		FromUserId int64   `json:",optional"` // 填写文章的人,服务端自动获取
		Pid        int64   `json:"commnet"`   // 回复那个评论的id
		Content    string  `json:"content"`   // 评论的内容
		AtWho      []int64 `json:"atWho"`     // 填写评论时@的人
	}

	MiniCreateArticleCommentResponse {
		Id             int64           `json:"id"`
		Pid            int64           `json:"pid"`
		TopId          int64           `json:"topId"`
		ArtitceId      int64           `json:"articleId"`      // 文章id
		SectionId      int64           `json:"sectionId"`      // 段落id
		FromUserId     int64           `json:"fromUserId"`     // 填写评论的人
		FromUser       CommentAuthor   `json:"fromUser"`       // 填写评论的人
		ToUserId       int64           `json:"toUserId"`       // 回复哪个人
		ToUser         CommentAuthor   `json:"toUser"`         // 回复哪个人
		SectionContent string          `json:"sectionContent"` // 引用的文章内容文本
		CountReply     int             `json:"countReply"`     // 回复数量
		CountUserLove  int             `json:"countUserLove"`  // 用户点赞数量
		CountAdminLove int             `json:"countAdminLove"` // 运营点赞数量
		AtWho          []CommentAuthor `json:"atWho"`          // 填写评论时@的人
	}
)