添加评论

开发中

POSThttp://localhost:8098/admin/comment

添加评论接口

请求参数

Authorization: JWT

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

postId

number

文章 ID

必需

当前评论属于哪个文章

parentCommentId

number | null

父评论 ID

可选

当前评论的父评论，可 null。
如果此项为 null，则代表该评论是顶层评论（没有任何父评论）。
如果此项不为 null，则代表该评论是其他评论的子评论，而该项就是父评论的 ID。
评论最多只能有两层，即一个顶层评论可以有任意个子评论，但是子评论不能再有子评论。

replayCommentId

number | null

回复评论 ID

可选

要回复的评论的 ID，可 null。
如果此项不为 null，需要同时指定 parentCommentId。
如果你只是想回复顶层评论则无需设置此项，仅需设置 parentCommentId 即可。
此项是用于回复顶层评论下的子评论。

content

string

评论内容

必需

>= 1 字符

site

string <uri> | null

站点地址

可选

评论的用户的站点地址，可 null。

<= 512 字符

displayName

string

名称

必需

用于显示当前评论的用户名称。

<= 128 字符

string <email>

邮箱

必需

<= 128 字符

isPass

boolean

是否通过审核

必需

标记当前评论是否通过审核，只有通过审核的评论才可以在前端获取到（如果博客设置了评论无需审核，此项默认为 true，设置无效）。

默认值:

false

{
  "postId": 0,
  "parentCommentId": 0,
  "replayCommentId": 0,
  "content": "string",
  "site": "http://example.com",
  "displayName": "string",
  "email": "user@example.com",
  "isPass": false
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

必需

errMsg

string | null

必需

data

object | null

必需

commentId

number

评论 ID

必需

postId

number

文章 ID

必需

parentCommentId

number | null

父评论 ID

必需

replayCommentId

number | null

回复评论 ID

必需

replayDisplayName

string | null

回复的评论名称

必需

content

string

评论内容

必需

site

string | null

站点地址

必需

displayName

string

名称

必需

string

邮箱

必需

createTime

number

创建时间戳

必需

isPass

boolean

是否通过审核

必需

children

null

子评论数组

必需

由于是新添加的评论，所以不存在子评论，该项正常情况总是为 null。

{
  "code": 200,
  "errMsg": null,
  "data": {
    "commentId": 1,
    "postId": 4,
    "parentCommentId": null,
    "replayCommentId": null,
    "replayDisplayName": null,
    "content": "这是一个评论内容",
    "site": null,
    "displayName": "我不是罗大锤",
    "email": "admin@loac.cc",
    "createTime": 1725723158827,
    "isPass": true,
    "children": null
  }
}

最后修改时间： 3 个月前