# 查询回复接口[列表]

  • 接口说明: 查询回复[列表]
  • 接口地址: /api/posts
  • 请求方式: GET

# 请求参数

参数名称 类型 是否必须 描述
include string 关联数据
filter[q] string 关键词
filter[userId] int 作者 ID
filter[username] string 作者用户名
filter[deletedUserId] int 操作删除者 ID
filter[deletedUsername] string 操作删除者用户名
filter[createdAtBegin] string 发表于(开始时间)
filter[createdAtEnd] string 发表于(结束时间)
filter[deletedAtBegin] string 删除于(开始时间)
filter[deletedAtEnd] string 删除于(结束时间)
filter[categoryId] int 分类 ID
filter[thread] int 主题 ID
filter[reply] int 回复 ID
filter[isApproved] string 是否合法(0/1/2) 0 不合法 1 正常 2 忽略
filter[isDeleted] string 是否删除(yes/no)
filter[isComment] string 是否是回复的评论(yes/no)
filter[highlight] string 是否高亮敏感词(yes/no)

# include 可关联的数据

关联名称 模型 类型 是否默认 描述
user users object 发表用户
replyUser users object 所回复的用户
commentUser users object 楼中楼关联的用户信息
images attachments array 回复下的图片
thread threads object 所属主题
user.groups groups object 用户所在群组
thread.category categories object 所属主题的分类
thread.firstPost posts object 所属主题的首贴
lastThreeComments posts object 最后三条回复
lastThreeComments.user posts object 最后三条回复的作者
lastThreeComments.replyUser posts object 最后三条回复被回复的用户
lastThreeComments.commentUser posts object 最后三条楼中楼用户
lastThreeComments.images attachments object 最后三条回复的图片
deletedUser users object 删除用户
lastDeletedLog operation-logs object 最后一次被删除的操作日志

# 请求示例

// 用户 ID
/api/posts?filter[userId]=1

// 主题 ID
/api/posts?filter[thread]=1

// 回复 ID
/api/posts?filter[reply]=1

// 查看待审核 filter[isApproved]=0
/api/posts?filter[isApproved]=0

// 查看回收站 filter[isDeleted]=yes
/api/posts?filter[isDeleted]=yes

# 返回说明

  • 成功,http 状态码: 200
  • 失败,http 状态码: 404

# 返回结果

关联数据模型字段释义参见请参见相应文档

参数名称 类型 出现要求 描述
**links** object 接口链接
**data** object 基础数据
type string 数据类型
id int 数据 id
**attributes** object 数据属性
replyUserId int|null 所回复的用户 ID
summary string 摘要
content string 内容
contentHtml string html 内容
ip string 发布 ip
replyCount int 回复数
likeCount int 喜欢数
createdAt datetime 创建时间
updatedAt datetime 修改时间
deletedAt datetime 在回收站时 删除时间
isFirst bool 是否首帖
isComment bool 是否是评论
isApproved bool 是否合法(0/1/2) 0 不合法 1 正常 2 忽略
isLiked bool 是否喜欢
canEdit bool 是否有权编辑
canApprove bool 是否有权审核
canDelete bool 是否有权永久删除
canHide bool 是否有权放入回收站
canLike bool 是否有权点赞
isLiked bool 是否喜欢
rewards int 评论获取到的悬赏金额,0为没有
redPacketAmount int 用户评论获得的红包总金额
**relationships** object 关联关系
**included** object 关联数据

# 返回示例

{
  "data": [
    {
      "type": "Posts",
      "id": "1",
      "attributes": {
        "content": "<i>hahahahh</i> :ku: Idaho Yuan Renminbi Gorgeous Soft <span class=\"highlight\">Car eco-centric == purple == neural Orchard Computer fuchsia optimizing",
        "contentHtml": "&lt;i&gt;hahahahh&lt;/i&gt; <img src=\"emoji/qq/ku.gif\" alt=\":ku:\"> Idaho Yuan Renminbi Gorgeous Soft <span class=\"highlight\">Car eco-centric == purple == neural Orchard Computer fuchsia optimizing",
        "ip": "127.0.0.1",
        "replyCount": 0,
        "likeCount": 0,
        "createdAt": "2019-11-12T17:10:23+08:00",
        "updatedAt": "2019-11-12T17:10:23+08:00",
        "isFirst": true,
        "isApproved": true,
        "isLiked": false
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "1"
          }
        }
      }
    },
    {
      "type": "Posts",
      "id": "2",
      "attributes": {
        "content": "Berkshire Legacy Public-key Bedfordshire Auto Loan Account == lime == Group incentivize exploit backing up port",
        "ip": "127.0.0.1",
        "replyCount": 0,
        "likeCount": 0,
        "createdAt": "2019-11-12T17:10:27+08:00",
        "updatedAt": "2019-11-12T17:10:27+08:00",
        "isFirst": true,
        "isApproved": true,
        "isLiked": false,
		"rewards": 0,
        "redPacketAmount": 1,
      },
      "relationships": {
        "user": {
          "data": {
            "type": "users",
            "id": "1"
          }
        }
      }
    }
  ],
  "included": [
    {
      "type": "users",
      "id": "1",
      "attributes": {
        "username": "username",
        "nickname": null,
        "mobile": "",
        "unionId": "",
        "lastLoginIp": "127.0.0.1",
        "createdAt": "2019-10-11T00:00:00+08:00",
        "updatedAt": "2019-11-11T14:51:34+08:00"
      }
    }
  ]
}