添加评论

开发中

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

返回响应

🟢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

获取日记

获取评论