menu MDClub JavaScript SDK 文档

NotificationApi.readMultiple

注意:该接口需要登陆后才能调用。

批量把通知标记为已读。

方法定义

NotificationApi.readMultiple(param: ReadMultipleParams): Promise<NotificationsResponse>

参数

ReadMultipleParams NotificationApi.ts:131

参数名必选类型说明
include否string

响应中需要包含的关联数据,用 , 分隔。可以为 receiver, sender, article, question, answer, comment, reply

notification_ids是string

多个用 , 分隔的通知ID,最多提供 100 个 ID

响应

NotificationsResponse models.ts:693

参数名类型说明
codenumber

无任何错误时,状态码为 0

dataNotification[]
paginationPagination

Notification models.ts:573

参数名类型说明
answer_idnumber

相关回答ID

article_idnumber

相关文章ID

comment_idnumber

相关评论ID

content_deletedQuestion|Article|Answer|Comment

已删除的数据,包含以下对象之一,数据中不包含 relationships

取值范围包括:Question、Article、Answer、Comment

create_timenumber

通知发送时间

notification_idnumber

通知ID

question_idnumber

相关提问ID

read_timenumber

通知阅读时间

receiver_idnumber

通知接收者ID

relationshipsNotificationRelationship
reply_idnumber

相关回复ID

sender_idnumber

通知发送者ID

typestring

通知类型:

  • question_answered:有人对提问发表了回答。此时会包含 question_id、answer_id
  • question_commented:有人对提问发表了评论。此时会包含 question_id、comment_id
  • question_deleted:提问被删除。此时会包含 question_id,但 relationships 中将不存在 question,可从 content_deleted 字段中获取被删除的提问内容
  • article_commented:有人对文章发表了评论。此时会包含 article_id、comment_id
  • article_deleted:文章被删除。此时会包含 article_id,但 relationships 中将不存在 article,可从 content_deleted 字段中获取被删除的文章内容
  • answer_commented:有人对回答发表了评论。此时会包含 question_id、answer_id、comment_id
  • answer_deleted:回答被删除。此时会包含 answer_id、question_id,但 relationships 中将不包含 answer,可从 content_deleted 字段中获取被删除的回答内容
  • comment_replied:有人对评论发表了回复。此时会包含 reply_id、comment_id,额外的,评论属于提问时会包含 question_id,属于文章时会包含 article_id,属于回答时会包含 answer_id、question_id
  • comment_deleted:评论被删除。此时会包含 comment_id,但 relationships 中将不包含 comment,可从 content_deleted 字段中获取被删除的评论内容;额外的,评论属于提问时会包含 question_id,属于文章时会包含 article_id,属于回答时会包含 answer_id、question_id

取值范围包括:question_answered、question_commented、question_deleted、article_commented、article_deleted、answer_commented、answer_deleted、comment_replied、comment_deleted

Pagination models.ts:1426

参数名类型说明
nextnumber

下一页页码,为 null 表示没有下一页

pagenumber

当前页码

pagesnumber

总页数

per_pagenumber

每页条数

previousnumber

上一页页码,为 null 表示没有上一页

totalnumber

数据总数

Question models.ts:1453

参数名类型说明
answer_countnumber

回答数量

comment_countnumber

评论数量

content_markdownstring

Markdown 格式的提问内容

content_renderedstring

HTML 格式的提问内容

create_timenumber

创建时间

delete_timenumber

🔐删除时间

follower_countnumber

关注者数量

last_answer_timenumber

最后回答时间

question_idnumber

提问ID

relationshipsQuestionRelationship
titlestring

提问标题

update_timenumber

更新时间(更新提问本身,或在提问下发表回答,都会更新该字段)

user_idnumber

用户ID

vote_countnumber

投票数(赞成票 - 反对票,可能为负数)

vote_down_countnumber

反对票总数

vote_up_countnumber

赞成票总数

Article models.ts:118

参数名类型说明
article_idnumber

文章ID

comment_countnumber

评论数量

content_markdownstring

Markdown 格式的文章内容

content_renderedstring

HTML 格式的文章内容

create_timenumber

创建时间

delete_timenumber

🔐删除时间

follower_countnumber

关注者数量

relationshipsArticleRelationship
titlestring

文章标题

update_timenumber

更新时间(用户可以更新自己的文章)

user_idnumber

用户ID

vote_countnumber

投票数(赞成票 - 反对票,可能为负数)

vote_down_countnumber

反对票总数

vote_up_countnumber

赞成票总数

Answer models.ts:1

参数名类型说明
answer_idnumber

回答ID

comment_countnumber

评论数量

content_markdownstring

markdown 格式的内容

content_renderedstring

html 格式的内容

create_timenumber

创建时间

delete_timenumber

🔐删除时间

question_idnumber

提问ID

relationshipsAnswerRelationship
update_timenumber

更新时间

user_idnumber

用户ID

vote_countnumber

投票数(赞成票 - 反对票,可能为负数)

vote_down_countnumber

反对票总数

vote_up_countnumber

赞成票总数

Comment models.ts:285

参数名类型说明
comment_idnumber

评论ID

commentable_idnumber

评论目标的ID

commentable_typestring

评论目标类型

取值范围包括:article、question、answer、comment

contentstring

评论内容

create_timenumber

发表时间

delete_timenumber

🔐删除时间

relationshipsCommentRelationship
update_timenumber

修改时间

user_idnumber

用户ID

vote_countnumber

投票数(赞成票 - 反对票,可能为负数)

vote_down_countnumber

反对票总数

vote_up_countnumber

赞成票总数

NotificationRelationship models.ts:675

参数名类型说明
answerAnswerInRelationship
articleArticleInRelationship
commentCommentInRelationship
questionQuestionInRelationship
receiverUserInRelationship
replyCommentInRelationship
senderUserInRelationship

QuestionRelationship models.ts:1555

参数名类型说明
is_followingboolean

当前登录用户是否已关注该提问

topicsTopicInRelationship[]
userUserInRelationship
votingstring

当前登录用户的投票类型(up、down),未投过票则为空字符串

取值范围包括:up、down、

ArticleRelationship models.ts:212

参数名类型说明
is_followingboolean

当前登录用户是否已关注该文章

topicsTopicInRelationship[]
userUserInRelationship
votingstring

当前登录用户的投票类型(up、down),未投过票则为空字符串

取值范围包括:up、down、

AnswerRelationship models.ts:76

参数名类型说明
questionQuestionInRelationship
userUserInRelationship
votingstring

当前登录用户的投票类型(up、down),未投过票则为空字符串

取值范围包括:up、down、

CommentRelationship models.ts:361

参数名类型说明
userUserInRelationship
votingstring

当前登录用户的投票类型(up、down),未投过票则为空字符串

取值范围包括:up、down、

AnswerInRelationship models.ts:53

参数名类型说明
answer_idnumber

回答ID

content_summarystring

内容摘要

create_timenumber

发布时间

question_idnumber

提问ID

update_timenumber

更新时间

ArticleInRelationship models.ts:193

参数名类型说明
article_idnumber

文章ID

create_timenumber

发布时间

titlestring

文章标题

update_timenumber

更新时间

CommentInRelationship models.ts:342

参数名类型说明
comment_idnumber

评论ID

content_summarystring

内容摘要

create_timenumber

发布时间

update_timenumber

更新时间

QuestionInRelationship models.ts:1536

参数名类型说明
create_timenumber

发布时间

question_idnumber

提问ID

titlestring

提问标题

update_timenumber

更新时间

UserInRelationship models.ts:2162

参数名类型说明
avatarUserAvatar
headlinestring

一句话介绍

user_idnumber

用户ID

usernamestring

用户名

CommentInRelationship models.ts:342

参数名类型说明
comment_idnumber

评论ID

content_summarystring

内容摘要

create_timenumber

发布时间

update_timenumber

更新时间

UserInRelationship models.ts:2162

参数名类型说明
avatarUserAvatar
headlinestring

一句话介绍

user_idnumber

用户ID

usernamestring

用户名

TopicInRelationship models.ts:1933

参数名类型说明
coverTopicCover
namestring

话题名称

topic_idnumber

话题 ID

UserInRelationship models.ts:2162

参数名类型说明
avatarUserAvatar
headlinestring

一句话介绍

user_idnumber

用户ID

usernamestring

用户名

TopicInRelationship models.ts:1933

参数名类型说明
coverTopicCover
namestring

话题名称

topic_idnumber

话题 ID

UserInRelationship models.ts:2162

参数名类型说明
avatarUserAvatar
headlinestring

一句话介绍

user_idnumber

用户ID

usernamestring

用户名

QuestionInRelationship models.ts:1536

参数名类型说明
create_timenumber

发布时间

question_idnumber

提问ID

titlestring

提问标题

update_timenumber

更新时间

UserInRelationship models.ts:2162

参数名类型说明
avatarUserAvatar
headlinestring

一句话介绍

user_idnumber

用户ID

usernamestring

用户名

UserInRelationship models.ts:2162

参数名类型说明
avatarUserAvatar
headlinestring

一句话介绍

user_idnumber

用户ID

usernamestring

用户名

UserAvatar models.ts:2094

参数名类型说明
largestring

大头像地址

middlestring

中头像地址

originalstring

头像原图地址

smallstring

小头像地址

UserAvatar models.ts:2094

参数名类型说明
largestring

大头像地址

middlestring

中头像地址

originalstring

头像原图地址

smallstring

小头像地址

TopicCover models.ts:1899

参数名类型说明
largestring

大型封面地址

middlestring

中型封面地址

originalstring

封面原图地址

smallstring

小型封面地址

UserAvatar models.ts:2094

参数名类型说明
largestring

大头像地址

middlestring

中头像地址

originalstring

头像原图地址

smallstring

小头像地址

TopicCover models.ts:1899

参数名类型说明
largestring

大型封面地址

middlestring

中型封面地址

originalstring

封面原图地址

smallstring

小型封面地址

UserAvatar models.ts:2094

参数名类型说明
largestring

大头像地址

middlestring

中头像地址

originalstring

头像原图地址

smallstring

小头像地址

UserAvatar models.ts:2094

参数名类型说明
largestring

大头像地址

middlestring

中头像地址

originalstring

头像原图地址

smallstring

小头像地址

UserAvatar models.ts:2094

参数名类型说明
largestring

大头像地址

middlestring

中头像地址

originalstring

头像原图地址

smallstring

小头像地址