Nola

添加评论

开发中

POSThttp://localhost:8098/api/comment

添加评论。
该接口受到访问请求限制，在 30 秒内最多可以请求 2 次。

请求参数

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 字符

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

示例代码

返回响应

成功(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 个月前