MDClubAPI 文档

Question:getAnswers

获取指定提问下的回答。

HTTP 请求

GET /api/questions/{question_id}/answers

参数

参数名参数位置类型默认值说明
question_idpathinteger

提问ID

pagequeryinteger1

当前页数

per_pagequeryinteger15

每页条数（最大为 100）

orderquerystring-create_time

排序方式。在字段前加 - 表示倒序排列。

可排序字段包括 vote_count、create_time、update_time、delete_time。默认为 -create_time。其中 delete_time 值仅管理员使用有效。

取值范围包括：vote_count, create_time, update_time, delete_time, -vote_count, -create_time, -update_time, -delete_time

includequerystring

响应中需要包含的关联数据，用 , 分隔。可以为 user, question, voting

响应

回答列表

示例

{
  "code": 0,
  "data": [
    {
      "answer_id": 1,
      "question_id": 1,
      "user_id": 1,
      "content_markdown": "**mdui** [https://mdui.org](https://mdui.org)
mdui 是目前最具有逻辑性、一致性、简洁性、高可用、且对规范实现的最好的 Material Design 框架。
**MDClub** [https://mdclub.org](https://mdclub.org)
MDClub 是使用 mdui 作为前端框架的开源社区应用。
",
      "content_rendered": "<p><strong>mdui</strong> <a href="https://mdui.org" target="_blank">https://mdui.org</a> <br>mdui 是目前最具有逻辑性、一致性、简洁性、高可用、且对规范实现的最好的 Material Design 框架。</p><p><strong>MDClub</strong> <a href="https://mdclub.org" target="_blank">https://mdclub.org</a> <br>MDClub 是使用 mdui 作为前端框架的开源社区应用。</p>",
      "comment_count": 23,
      "vote_count": 44,
      "vote_up_count": 96,
      "vote_down_count": 52,
      "create_time": 1563512214,
      "update_time": 1563512214,
      "delete_time": 0,
      "relationships": {
        "user": {
          "user_id": 1,
          "username": "zdhxiong",
          "headline": "mdui作者",
          "avatar": {
            "original": "https://mdclub.org/user-avatar/c4/ca/bc03445db47540eea79148252e7a91fe.jpg",
            "small": "https://mdclub.org/user-avatar/c4/ca/bc03445db47540eea79148252e7a91fe_small.jpg",
            "middle": "https://mdclub.org/user-avatar/c4/ca/bc03445db47540eea79148252e7a91fe_middle.jpg",
            "large": "https://mdclub.org/user-avatar/c4/ca/bc03445db47540eea79148252e7a91fe_large.jpg"
          }
        },
        "question": {
          "question_id": 1,
          "title": "请问作者开发了哪些软件？",
          "create_time": 1563512214,
          "update_time": 1563512214
        },
        "voting": "up"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 15,
    "previous": null,
    "next": 2,
    "total": 124,
    "pages": 9
  }
}

参数说明

参数名 类型 说明
code integer

无任何错误时，状态码为 0
data[].answer_id integer

回答ID
data[].question_id integer

提问ID
data[].user_id integer

用户ID
data[].content_markdown string

markdown 格式的内容
data[].content_rendered string

html 格式的内容
data[].comment_count integer

评论数量
data[].vote_count integer

投票数（赞成票 - 反对票，可能为负数）
data[].vote_up_count integer

赞成票总数
data[].vote_down_count integer

反对票总数
data[].create_time integer

创建时间
data[].update_time integer

更新时间
data[].delete_time integer

🔐删除时间
data[].relationships.user.user_id integer

用户ID
data[].relationships.user.username string

用户名
data[].relationships.user.headline string

一句话介绍
data[].relationships.user.avatar.original string

头像原图地址
data[].relationships.user.avatar.small string

小头像地址
data[].relationships.user.avatar.middle string

中头像地址
data[].relationships.user.avatar.large string

大头像地址
data[].relationships.question.question_id integer

提问ID
data[].relationships.question.title string

提问标题
data[].relationships.question.create_time integer

发布时间
data[].relationships.question.update_time integer

更新时间
data[].relationships.voting string

当前登录用户的投票类型（up、down），未投过票则为空字符串

取值范围包括：up, down,

pagination.page integer

当前页码
pagination.per_page integer

每页条数
pagination.previous integer

上一页页码，为 null 表示没有上一页
pagination.next integer

下一页页码，为 null 表示没有下一页
pagination.total integer

数据总数
pagination.pages integer

总页数