发布评论接口

允许用户对指定文档发布评论,支持普通评论和回复评论功能。

注意事项

  • 该接口采用POST方法,需要以application/json格式提交数据
  • 需要提供有效的文档ID、用户名和评论内容
  • 支持发布针对其他评论的回复(通过parent_id参数)
  • 评论可能需要审核后才能显示(根据status字段判断)
  • 需要确保域名地址正确配置
  • 可能有评论频率限制,防止刷评论

请求地址

{域名地址}/api/comment/publish

说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/comment/publish

请求语法

POST /api/comment/publish
Content-Type: application/json

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

请求参数

字段名 类型 必填 说明
archive_id int 评论的文档 id
user_name string 用户名
content string 评论内容
parent_id int 引用的评论 ID

响应头

此接口仅涉及公共相应头。更多信息,请参见公共请求头(Common Request Headers)

返回参数

字段名 类型 说明
code int 错误码
msg string 错误原因说明
data object 结果内容

data 结果

字段名 类型 说明
id int 评论 ID
parent_id int 评论的上级 ID
archive_id int 文档 ID
user_name string 评论用户名
user_id int 评论用户 ID
ip string 评论者 IP
vote_count int 点赞数量
content string 分类内容详情
created_time int 发布时间戳
updated_time int 更新时间戳
status int 审核状态,1 已审核,0 审核中

使用示例

请求示例

POST /api/comment/publish HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json

{
  "user_name": "anqicms",
  "content": "欢迎使用anqicms",
  "archive_id": 140
}

响应示例

{
  "code": 0,
  "data": {
    "id": 33,
    "created_time": 1662734920,
    "updated_time": 1662734920,
    "archive_id": 140,
    "user_id": 0,
    "user_name": "anqicms",
    "ip": "127.0.0.1",
    "vote_count": 0,
    "content": "欢迎使用anqicms",
    "parent_id": 0,
    "status": 0
  },
  "msg": "发布成功"
}

错误代码

错误码 说明
0 OK
-1 错误,错误原因在 msg 中指出
1001 未登录
1002 未授权
200 API 请求 OK