登录
目录
当前位置： 首页 > 文档资料 > ThinkSNS Plus 官网中文文档 >

问题

优质
小牛编辑
128浏览
2023-12-01

发布问题

POST /questions

输入

字段类型描述
subject字符串必须，问题主题或者说标题，不能超过 255 字节 ，必须以 ？ 结尾。（不区分全角或者半角）
topics数组必须，绑定的话题，数组子节点必须符合 { "id": 1 } 的格式。
body字符串问题描述。
anonymity枚举：0 或者 1作者是否匿名发布。
amount数字问题价值，悬赏金额
look枚举：0 或者 1是否开启围观，当问题有采纳或者邀请人已回答，则对外部观众自动开启围观。设置围观必须设置悬赏金额。
invitations数组邀请回答，问题邀请回答的人，数组子节点必须符合 { "user": 1 } 的格式，切不能存在自己。
automaticity枚举：0 或者 1邀请悬赏自动入账，只邀请一个人的情况下，允许悬赏金额自动入账到被邀请回答者钱包中。
text_body字符串纯文字回答内容，用于列表显示
passwordstring根据启动信息决定是否传递，用户密码，支付需要用户输入密码进行付费支付。）

响应

Status: 201 Created

{
  "message": [
    "操作成功"
  ],
  "question": {
    "subject": "再测试一个问题?",
    "body": null,
    "anonymity": 1,
    "amount": 0,
    "automaticity": 0,
    "look": 0,
    "user_id": 1,
    "updated_at": "2017-08-01 06:06:37",
    "created_at": "2017-08-01 06:06:37",
    "text_body": "12312",
    "id": 2
  }
}

更新问题

PATCH /questions/:question

输入

字段类型描述
subject字符串当 body / anonymity / topics / amount 不存在时，subject 为必须，问题主题或者说标题，不能超过 255 字节 ，必须以 ？ 结尾。（不区分全角或者半角）
body字符串当 subject / anonymity / topics / amount 不存在时，body 为必须，问题描述。
anonymity1 or 0当 subject / body / topics / amount 不存在时，anonymity 为必须，是否匿名。
topics数组当 subject / anonymity / body / amount 不存在时，topics 为必须，问题关联话题，数组子节点必须符合 { "id": 1 } 的格式。
ammountint当 subject / anonymity / body / topics 不存在时，amount 为必须，悬赏金额。
text_body字符串纯文字回答内容，用于列表显示

响应

Status: 204 No Content

设置问题悬赏

在没有采纳和邀请且未设置悬赏金额时，问题作者重新设置问题的悬赏

PATCH /questions/:question/amount

输入

字段类型描述
amountint悬赏金额

响应

Status: 204 No Content

获取问题列表

获取所有问题列表

GET /questions

参数

名称类型描述
type枚举：all、new、hot、reward、excellent默认值 new, all - 全部、new - 最新、hot - 热门、reward - 悬赏、excellent - 精选 follow - 关注 。
limitInteger默认 20 ，获取列表条数，修正值 1 - 30。
offsetinteger默认 0 ，数据偏移量，传递之前通过接口获取的总数。
subjectstring标题搜索关键字。
idstring按照问题 ID 返回问题列表，多个采用半角 , 进行分割。

响应

Status: 200 OK

[
  {
    "id": 5,
    "user_id": 1,
    "subject": "32?",
    "body": "1212",
    "anonymity": 0,
    "amount": 200,
    "automaticity": 1,
    "look": 1,
    "excellent": 0,
    "status": 0,
    "comments_count": 0,
    "answers_count": 0,
    "watchers_count": 0,
    "likes_count": 0,
    "views_count": 10,
    "created_at": "2017-08-21 08:39:42",
    "updated_at": "2017-08-22 03:17:13",
    "answer": null,
    "user": {
      "id": 1,
      "name": "baishi",
      "bio": null,
      "sex": 1,
      "location": null,
      "created_at": "2017-07-31 03:16:19",
      "updated_at": "2017-08-09 10:09:28",
      "avatar": null,
      "bg": null,
      "verified": {
        "type": "user",
        "icon": null,
        "description": "啦啦啦啦"
      },
      "extra": {
        "user_id": 1,
        "likes_count": 2,
        "comments_count": 9,
        "followers_count": 0,
        "followings_count": 0,
        "updated_at": "2017-08-17 07:05:06",
        "feeds_count": 0,
        "questions_count": 0,
        "answers_count": 19
      }
    }
  },
  {
    "id": 4,
    "user_id": 1,
    "subject": "啊撒大声地",
    "body": "啊撒大声地",
    "anonymity": 0,
    "amount": 200,
    "automaticity": 1,
    "look": 1,
    "excellent": 0,
    "status": 0,
    "comments_count": 2,
    "answers_count": 19,
    "watchers_count": 0,
    "likes_count": 0,
    "views_count": 1,
    "created_at": "2017-08-09 10:33:22",
    "updated_at": "2017-08-17 07:05:06",
    "answer": {
      "id": 7,
      "question_id": 4,
      "user_id": 1,
      "body": "baishi",
      "anonymity": 0,
      "adoption": 0,
      "invited": 1,
      "comments_count": 0,
      "rewards_amount": 32,
      "rewarder_count": 1,
      "likes_count": 0,
      "created_at": "2017-08-17 07:05:06",
      "updated_at": "2017-08-17 07:17:26",
      "liked": false,
      "collected": false,
      "rewarded": false,
      "could": false,
      "user": {
        "id": 1,
        "name": "baishi",
        "bio": null,
        "sex": 1,
        "location": null,
        "created_at": "2017-07-31 03:16:19",
        "updated_at": "2017-08-09 10:09:28",
        "avatar": null,
        "bg": null,
        "verified": {
          "type": "user",
          "icon": null,
          "description": "啦啦啦啦"
        },
        "extra": {
          "user_id": 1,
          "likes_count": 2,
          "comments_count": 9,
          "followers_count": 0,
          "followings_count": 0,
          "updated_at": "2017-08-17 07:05:06",
          "feeds_count": 0,
          "questions_count": 0,
          "answers_count": 19
        }
      }
    },
    "user": {
      "id": 1,
      "name": "baishi",
      "bio": null,
      "sex": 1,
      "location": null,
      "created_at": "2017-07-31 03:16:19",
      "updated_at": "2017-08-09 10:09:28",
      "avatar": null,
      "bg": null,
      "verified": {
        "type": "user",
        "icon": null,
        "description": "啦啦啦啦"
      },
      "extra": {
        "user_id": 1,
        "likes_count": 2,
        "comments_count": 9,
        "followers_count": 0,
        "followings_count": 0,
        "updated_at": "2017-08-17 07:05:06",
        "feeds_count": 0,
        "questions_count": 0,
        "answers_count": 19
      }
    }
  }
]

返回参数说明

字段描述
id问题唯一 ID 。
user_id发布的用户 ID，如果是 anonymity 是 1 则该字段为 0。
subject问题标题。
body问题详情，markdown，如果没有详情为 null。
anonymity是否匿名，1 代表匿名发布，匿名后不会返回任何用户信息。
amount问题价值，悬赏金额，0 代表非悬赏。
automaticity是否自动入账。客户端无用，邀请回答后端判断逻辑使用。
look是否开启了围观。
excellent是否属于精选问题。
status问题状态，0 - 未解决，1 - 已解决， 2 - 问题关闭 。
comments_count问题评论总数统计。
answers_count问题答案数量统计。
watchers_count问题关注的人总数统计。
likes_count喜欢问题的人总数统计。
views_count问题查看数量统计。
text_body问题内容纯文字字段，用于列表显示
created_at问题创建时间。
updated_at问题修改时间。
answer问题的最新一条回答，具体数据结构参考「回答」文档，问题没有回答时该字段为null。
answer.cloud该回答是否需要围观，所属问题开启围观时会存在，为 false 时回答内容返回为null
user用户资料，如果是 anonymity 是 1 则该字段不存在。

获取某个话题下的问题列表

GET /question-topics/:topic/questions

参数

名称类型描述
type枚举：all、new、hot、reward、excellent默认值 new, all - 全部、new - 最新、hot - 热门、reward - 悬赏、excellent - 精选 。
limitInteger默认 20 ，获取列表条数，修正值 1 - 30。
offsetinteger默认 0 ，数据偏移量，传递之前通过接口获取的总数。
subjectstring标题搜索关键字。

响应

Status: 200 OK

[
  {
    "id": 2,
    "user_id": 0,
    "subject": "再测试一个问题?",
    "body": null,
    "anonymity": 1,
    "amount": 0,
    "automaticity": 0,
    "look": 0,
    "excellent": 0,
    "status": 0,
    "comments_count": 0,
    "answers_count": 0,
    "watchers_count": 0,
    "likes_count": 0,
    "views_count": 0,
    "created_at": "2017-08-01 06:06:37",
    "updated_at": "2017-08-01 06:06:37"
  },
  {
    "id": 1,
    "user_id": 1,
    "subject": "第一个提问?",
    "body": null,
    "anonymity": 0,
    "amount": 0,
    "automaticity": 0,
    "look": 0,
    "excellent": 0,
    "status": 0,
    "comments_count": 0,
    "answers_count": 3,
    "watchers_count": 0,
    "likes_count": 0,
    "views_count": 0,
    "created_at": "2017-07-28 08:38:54",
    "updated_at": "2017-08-01 06:03:21",
    "user": {
      "id": 1,
      "name": "Seven",
      "bio": "Seven 的个人传记",
      "sex": 2,
      "location": "成都 中国",
      "created_at": "2017-06-02 08:43:54",
      "updated_at": "2017-07-25 03:59:39",
      "avatar": "http://plus.io/api/v2/users/1/avatar",
      "bg": "https://www.xnip.cn/wp-content/uploads/2021/docimg15/32-oa5d5rzh4fa.png",
      "verified": null,
      "extra": {
        "user_id": 1,
        "likes_count": 0,
        "comments_count": 8,
        "followers_count": 0,
        "followings_count": 1,
        "updated_at": "2017-08-01 06:06:37",
        "feeds_count": 0,
        "questions_count": 5,
        "answers_count": 3
      }
    }
  }
]

字段注明情查看 「获取一个问题详情」，列表值返回一部分主要数据。

获取一个问题详情

GET /questions/:question

响应

Status: 200 OK

{
  "id": 1,
  "user_id": 1,
  "subject": "第一个提问?",
  "body": null,
  "anonymity": 0,
  "amount": 0,
  "automaticity": 1,
  "look": 1,
  "excellent": 0,
  "status": 0,
  "comments_count": 0,
  "answers_count": 3,
  "watchers_count": 0,
  "likes_count": 0,
  "views_count": 0,
  "created_at": "2017-07-28 08:38:54",
  "updated_at": "2017-08-01 06:03:21",
  "my_answer": null,
  "watched": false,
  "invitation_answers": [
    {
      "id": 2,
      "question_id": 1,
      "user_id": 2,
      "body": null,
      "anonymity": 0,
      "adoption": 0,
      "invited": 1,
      "comments_count": 0,
      "rewards_amount": 0,
      "rewarder_count": 0,
      "likes_count": 0,
      "created_at": "2017-08-01 03:44:04",
      "updated_at": "2017-08-01 03:44:04",
      "could": false,
      "onlookers_count": 1,
      "onlookers_total": 10,
      "user": {
        "id": 2,
        "name": "test1",
        "bio": "0",
        "sex": 0,
        "location": "0",
        "created_at": "2017-06-12 07:38:55",
        "updated_at": "2017-06-12 07:38:55",
        "avatar": null,
        "bg": null,
        "verified": null,
        "extra": null
      }
    }
  ],
  "adoption_answers": [
    {
      "id": 3,
      "question_id": 1,
      "user_id": 1,
      "body": "终于回答成功",
      "anonymity": 1,
      "adoption": 1,
      "invited": 0,
      "comments_count": 0,
      "rewards_amount": 0,
      "rewarder_count": 0,
      "likes_count": 0,
      "created_at": "2017-08-01 06:03:21",
      "updated_at": "2017-08-01 06:03:21",
      "could": true,
      "user": {
        "id": 1,
        "name": "Seven",
        "bio": "Seven 的个人传记",
        "sex": 2,
        "location": "成都 中国",
        "created_at": "2017-06-02 08:43:54",
        "updated_at": "2017-07-25 03:59:39",
        "avatar": "http://plus.io/api/v2/users/1/avatar",
        "bg": "https://www.xnip.cn/wp-content/uploads/2021/docimg15/32-oa5d5rzh4fa.png",
        "verified": null,
        "extra": {
          "user_id": 1,
          "likes_count": 0,
          "comments_count": 8,
          "followers_count": 0,
          "followings_count": 1,
          "updated_at": "2017-08-01 06:06:37",
          "feeds_count": 0,
          "questions_count": 5,
          "answers_count": 3
        }
      }
    }
  ],
  "topics": [
    {
      "id": 1,
      "name": "PHP",
      "description": "我是PHP",
      "questions_count": 5,
      "experts_count": 1,
      "follows_count": 0,
      "avatar": null
    }
  ],
  "invitations": [
    {
      "id": 2,
      "name": "test1",
      "bio": "0",
      "sex": 0,
      "location": "0",
      "created_at": "2017-06-12 07:38:55",
      "updated_at": "2017-06-12 07:38:55",
      "avatar": null,
      "bg": null,
      "verified": null,
      "extra": null
    }
  ],
  "user": {
    "id": 1,
    "name": "Seven",
    "bio": "Seven 的个人传记",
    "sex": 2,
    "location": "成都 中国",
    "created_at": "2017-06-02 08:43:54",
    "updated_at": "2017-07-25 03:59:39",
    "avatar": "http://plus.io/api/v2/users/1/avatar",
    "bg": "https://www.xnip.cn/wp-content/uploads/2021/docimg15/32-oa5d5rzh4fa.png",
    "verified": null,
    "extra": {
      "user_id": 1,
      "likes_count": 0,
      "comments_count": 8,
      "followers_count": 0,
      "followings_count": 1,
      "updated_at": "2017-08-01 06:06:37",
      "feeds_count": 0,
      "questions_count": 5,
      "answers_count": 3
    }
  }
}
字段描述
id问题唯一 ID 。
user_id发布的用户 ID，如果是 anonymity 是 1 则该字段为 0。
subject问题标题。
body问题详情，markdown，如果没有详情为 null。
anonymity是否匿名，1 代表匿名发布，匿名后不会返回任何用户信息。
amount问题价值，悬赏金额，0 代表非悬赏。
automaticity是否自动入账。客户端无用，邀请回答后端判断逻辑使用。
look是否开启了围观。
excellent是否属于精选问题。
status问题状态，0 - 未解决，1 - 已解决， 2 - 问题关闭 。
comments_count问题评论总数统计。
answers_count问题答案数量统计。
watchers_count问题关注的人总数统计。
likes_count喜欢问题的人总数统计。
views_count问题查看数量统计。
created_at问题创建时间。
updated_at问题修改时间。
my_answer我的回答，数据结构参考回答列表，没有时为null
watched用户是否关注这个问题。
invitation_answers问题邀请用户回答的答案列表，具体数据结构参考「回答」文档。
invitation_answers.onlookers_count该回答被围观人数
invitation_answers.onlookers_total被围观总金额
invitation_answers.cloud该回答是否需要围观，所属问题开启围观时会存在，为 false 时回答内容返回为null
adoption_answers问题采纳的答案列表，具体数据结构参考「回答」文档。
topics问题话题列表，参考「话题」文档。
invitations问题邀请回答的用户列表，参考「用户」文档。
user用户资料，如果是 anonymity 是 1 则该字段不存在。

如果匿名提问是当前请求的认证用户所发布，则返回用户信息。

删除一个问题

DELETE /questions/:question

响应

Status: 204 No Content

获取用户发布的问题列表

GET /api/v2/user/questions

输入

名称类型描述
limitint数据条数
afterint翻页标识
user_idint用户id 不传默认为当前用户
typestring数据筛选类型 all-全部 invitation-邀请 reward-悬赏 other-其他 默认全部

响应

Status 200 Ok

[
  {
    "id": 5,
    "user_id": 1,
    "subject": "32?",
    "body": "1212",
    "anonymity": 0,
    "amount": 200,
    "automaticity": 1,
    "look": 1,
    "excellent": 0,
    "status": 0,
    "comments_count": 0,
    "answers_count": 0,
    "watchers_count": 0,
    "likes_count": 0,
    "views_count": 10,
    "created_at": "2017-08-21 08:39:42",
    "updated_at": "2017-08-22 03:17:13",
    "answer": null,
    "user": {
      "id": 1,
      "name": "baishi",
      "bio": null,
      "sex": 1,
      "location": null,
      "created_at": "2017-07-31 03:16:19",
      "updated_at": "2017-08-09 10:09:28",
      "avatar": null,
      "bg": null,
      "verified": null,
      "extra": {
        "user_id": 1,
        "likes_count": 2,
        "comments_count": 9,
        "followers_count": 0,
        "followings_count": 0,
        "updated_at": "2017-08-17 07:05:06",
        "feeds_count": 0,
        "questions_count": 0,
        "answers_count": 19
      }
    }
  },
  {
    "id": 4,
    "user_id": 1,
    "subject": "啊撒大声地",
    "body": "啊撒大声地",
    "anonymity": 0,
    "amount": 200,
    "automaticity": 1,
    "look": 1,
    "excellent": 0,
    "status": 0,
    "comments_count": 2,
    "answers_count": 19,
    "watchers_count": 0,
    "likes_count": 0,
    "views_count": 1,
    "created_at": "2017-08-09 10:33:22",
    "updated_at": "2017-08-17 07:05:06",
    "answer": {
      "id": 7,
      "question_id": 4,
      "user_id": 1,
      "body": "baishi",
      "anonymity": 0,
      "adoption": 0,
      "invited": 1,
      "comments_count": 0,
      "rewards_amount": 32,
      "rewarder_count": 1,
      "likes_count": 0,
      "created_at": "2017-08-17 07:05:06",
      "updated_at": "2017-08-17 07:17:26",
      "user": {
        "id": 1,
        "name": "baishi",
        "bio": null,
        "sex": 1,
        "location": null,
        "created_at": "2017-07-31 03:16:19",
        "updated_at": "2017-08-09 10:09:28",
        "avatar": null,
        "bg": null,
        "verified": null,
        "extra": {
          "user_id": 1,
          "likes_count": 2,
          "comments_count": 9,
          "followers_count": 0,
          "followings_count": 0,
          "updated_at": "2017-08-17 07:05:06",
          "feeds_count": 0,
          "questions_count": 0,
          "answers_count": 19
        }
      }
    },
    "user": {
      "id": 1,
      "name": "baishi",
      "bio": null,
      "sex": 1,
      "location": null,
      "created_at": "2017-07-31 03:16:19",
      "updated_at": "2017-08-09 10:09:28",
      "avatar": null,
      "bg": null,
      "verified": null,
      "extra": {
        "user_id": 1,
        "likes_count": 2,
        "comments_count": 9,
        "followers_count": 0,
        "followings_count": 0,
        "updated_at": "2017-08-17 07:05:06",
        "feeds_count": 0,
        "questions_count": 0,
        "answers_count": 19
      }
    }
  }
]

其他部分数据格式同问题列表

免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn