发布评论接口

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

    注意事项

    • 该接口采用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