Home

group-api

小组首页

• 地址：/api/group
• 请求方法：GET
• 是否需要认证：否
• 请求参数：无
• 返回数据：
  • groups: [group_dict]
  • manage: Boolean
  • apply_sent: [str(group_id)]
  • recent_joins: [recent_join]
  • hot_group: group_dict
  • hot_topics: [topic_dict]

我的小组

• 地址：/api/group/mine
• 请求方法：GET
• 是否需要认证：是
• 请求参数：
  • page: 1~n
  • tp: my或者manage
• 返回数据：
  • groups: [group_dict]
  • manage: Boolean

小组成员

• 地址：/api/group/{{group_id}}/members
• 请求方法：GET
• 是否需要认证：是
• 请求参数：
  • page: 1~n
• 返回数据：
  • members: [user]

小组详情

• 地址：/api/group/{{group_id}}
• 请求方法：GET
• 是否需要认证：否
• 请求参数：
  • page: 1~n
• 返回数据：
  • group: group_dict
    need_members_detail
  • topics: [topic_dict]
  • is_member: Boolean
  • ug_relation: 'g_admin'或'member'或'visit_public'或'semipub-sent'或'semipub-notsent'

话题详情

• 地址：/api/group/topic/{{topic_id}}
• 请求方法：GET
• 是否需要认证：否
• 请求参数：
  • page: 1~n
• 返回数据：
  • topic: topic_dict
    with_content, with_group, with_likes_users, with_pets
  • comments: [comment]
  • is_member: Boolean
  • ug_relation: 'g_admin'或'member'或'visit_public'或'semipub-sent'或'semipub-notsent'
  • liked: Boolean

加入/退出小组

• 地址：/api/group/{{group_id}}/access
• 请求方法：POST
• 是否需要认证：是
• 请求参数：
  • action: join或者quit

创建话题

• 地址：/api/group/{{group_id}}/create
• 请求方法：POST
• 是否需要认证：是
• 请求参数：
  • title: 文章标题
  • content: 文章内容
  • image: （可选）封面图片的uri
  • pet_id: （可选）和话题相关的宠物id，多个宠物id用-分隔
  • sns: （可选）True或者False

扩展话题

• 地址：/api/group/topic/{{topic_id}}/append
• 请求方法：POST
• 是否需要认证：是
• 请求参数：
  • content: 扩展话题的内容
  • image: （可选）扩展话题的图片的uri

喜欢话题

• 地址：/api/group/topic/{{topic_id}}/like
• 请求方法：POST
• 是否需要认证：是
• 请求参数：无

删除话题

• 地址：/api/group/topic/{{topic_id}}/delete
• 请求方法：POST
• 是否需要认证：是
• 请求参数：
  • channel: topic或者append，选择删除topic还是append
  • append: 1~n，append的楼层数，如果要删除topic，则不需要此参数

创建评论

• 地址：/api/group/topic/{{topic_id}}/comment
• 请求方法：POST
• 是否需要认证：是
• 请求参数：
  • text: 评论内容

删除评论

• 地址：/api/group/comment/{{comment_id}}/delete
• 请求方法：POST
• 是否需要认证：是
• 请求参数：无

上传图片

• 地址：/api/upload
• 请求方法：POST
• 是否需要认证：是
• 请求参数：
  • file: 本地图片