Nola

添加评论

开发中

POST

http://localhost:8098/api/comment

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

请求参数

Body 参数application/json

postId

number

文章 ID

必需

当前评论属于哪个文章

parentCommentId

number | null

父评论 ID

可选

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

replyCommentId

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,
  "replyCommentId": 0,
  "content": "string",
  "site": "http://example.com",
  "displayName": "string",
  "email": "user@example.com"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:8098/api/comment' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

Body

code

integer

必需

errMsg

string | null

必需

data

object | null

必需

commentId

number

评论 ID

必需

postId

number

文章 ID

必需

parentCommentId

number | null

父评论 ID

必需

replyCommentId

number | null

回复评论 ID

必需

replyDisplayName

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,
    "replyCommentId": null,
    "replyDisplayName": null,
    "content": "这是一个评论内容",
    "site": null,
    "displayName": "我不是罗大锤",
    "email": "admin@loac.cc",
    "createTime": 1725723158827,
    "isPass": true,
    "children": null
  }
}

修改于 2025-03-09 13:54:42

获取日记

获取评论