话题 - Topics

获取话题列表

获取话题列表,类似 Ruby China 话题列表的内容,支持多种排序方式。

GET /api/v3/topics

Parameters:

  • type (String) - 排序类型,default: last_actived
    • 可选值:last_actived, recent, no_reply, popular, excellent
  • node_id (Integer) - 节点编号,如果有给,就会只去节点下的话题
  • offset (Integer) - default: 0
  • limit (Integer) - default: 20, range: 1..150

Response

Array<TopicSerializer>

话题详情

获取话题详情(不含回帖)

GET /api/v3/topics/:id

Response

TopicDetailSerializer

创建新话题

创建一篇新的话题

POST /api/v3/topics

Parameters:

  • title (String) — 标题,[required]
  • node_id (Integer) — 节点编号,[required]
  • body (Markdown) — 格式的正文,[required]

Response

TopicDetailSerializer

修改话题

修改话题内容

PUT /api/v3/topics/:id

Parameters

  • title (String) — 标题,[required]
  • node_id (Integer) — 节点编号,[required]
  • body (Markdown) — 格式的正文,[required]

Response

TopicDetailSerializer

删除话题

删除一篇话题

DELETE /api/v3/topics/:id

创建回帖

创建对 :id 话题的回帖

POST /api/v3/topics/:id/replies

Parameters

  • body (String) - 回帖正文

Response

ReplySerializer

话题的回帖列表

获取话题的回帖列表

GET /api/v3/topics/:id/replies

Parameters

  • offset (Integer) - default: 0
  • limit (Integer) - default: 20, range: 1..150

Response

Array<ReplySerializer>

关注话题

POST /api/v3/topics/:id/follow

取消关注话题

POST /api/v3/topics/:id/unfollow

收藏话题

POST /api/v3/topics/:id/favorite

取消收藏话题

POST /api/v3/topics/:id/unfavorite

话题动作接口

:id 这篇话题发起动作(屏蔽、加精华、结束讨论...)注意类型有不同的权限,详见 GET /api/v3/topics/:id 返回的 abilities

POST /api/v3/topics/:id/action?type=:type

Parameters:

  • type (String) — 动作类型,ban - 屏蔽话题,excellent - 加精华,unexcellent - 去掉精华,close - 关闭回复,open - 开启回复