豆瓣线上活动 API V2

回 Api V2 首页

scope: community_basic_online

name Method endpoint
获取线上活动 GET /v2/online/:id
获取线上活动参加成员列表 GET /v2/online/:id/participants
获取线上活动论坛列表 GET /v2/online/:id/discussions
获取线上活动列表 GET /v2/onlines

scope: community_advanced_online

name Method endpoint
创建线上活动 POST /v2/onlines
更新线上活动 PUT /v2/online/:id
删除线上活动 DELETE /v2/online/:id
参加线上活动 POST /v2/online/:id/participants
退出线上活动 DELETE /v2/online/:id/participants
喜欢线上活动 POST /v2/online/:id/like
取消喜欢线上活动 DELETE /v2/online/:id/like
图片列表 GET /v2/online/:id/photos
上传图片 POST /v2/online/:id/photos
线上活动论坛发贴 POST /v2/online/:id/discussions
获取用户参加的线上活动列表 GET /v2/online/user_participated/:id
获取用户创建的线上活动列表 GET /v2/online/user_created/:id

Online

  1. {
  2.   "id": "11038343",
  3.   "alt": "http://www.douban.com/online/11038343/",
  5.   "title": "新的截图猜电影，来！",
  6.   "desc": "截图猜电影\r\n猜中后描述改为：\r\n《电影名》 by （猜中者名字）\r\n请遵守规则！\r\n\r\n附注：相关网址是，听>配乐>猜电影友情活动，尽请参加！",
  8.   "tags": ["截图", "电影", "交友", "猜图"],
  10.   "created": "2012-02-24 11:49:32",
  11.   "begin_time": "2012-02-24 11:00:00",
  12.   "end_time": "2012-05-23 11:00:00",
  14.   "related_url": "http://www.douban.com/online/10999361/",
  15.   "shuo_topic": "新的截图猜电影，来！", //对应广播的#主题#
  16.   "cascade_invite": true, //用户能不能邀请友邻加入
  17.   "group_id": "0", //关联小组的id
  18.   "album_id": "65606728", //对应相册的id
  20.   "participant_count": 13881, //参加人数
  21.   "photo_count": 63281, //照片数
  22.   "liked_count": 2127, //喜欢数
  23.   "recs_count": 417, //推荐数
  25.   "icon": "http://img6.douban.com/bpic/o590273.jpg",
  26.   "thumb": "http://img6.douban.com/spic/o590273.jpg",
  27.   "cover": "http://img6.douban.com/tpic/o590273.jpg",
  28.   "image": "http://img6.douban.com/lpic/o590273.jpg",
  30.   "owner": User,
  31.   //当前用户是否喜欢，参加
  32.   "liked": false,
  33.   "joined": false
  34. }

获取线上活动

  1. GET https://api.douban.com/v2/online/:id

返回 Online

获取线上活动参加成员列表

  1. GET https://api.douban.com/v2/online/:id/participants

返回 User 列表

获取线上活动论坛列表

  1. GET https://api.douban.com/v2/online/:id/discussions

返回 Discussion 列表

获取线上活动列表

  1. GET https://api.douban.com/v2/onlines
参数 意义 备注
cate 类别 day，week，latest 分别对应每天，每周，最新

返回 Online 列表

创建线上活动

  1. POST https://api.douban.com/v2/onlines

请求参数

参数 意义 备注
title 题目 不能为空
desc 描述 不能为空
begin_time 开始时间 不能为空，不是是过去的时间，时间格式”%Y-%m-%d %H:%M”
end_time 结束时间 不能为空，不能早于开始时间，活动期限不能长于 3 个月(90 天)
related_url 关联的 url 或者小组链接 可以为空
cascade_invite 是否允许参与的成员邀请朋友参加 默认为 false
tags 标签 不超过 4 个，用空格分开，默认为空

返回 200，创建好的Online

更新线上活动

  1. PUT https://api.douban.com/v2/online/:id

参数参考创建线上活动

删除线上活动

  1. DELETE https://api.douban.com//v2/online/:id

参加线上活动

  1. POST https://api.douban.com/v2/online/:id/participants

退出线上活动

  1. DELETE https://api.douban.com/v2/online/:id/participants

喜欢线上活动

  1. POST https://api.douban.com/v2/online/:id/like

取消喜欢线上活动

  1. DELETE https://api.douban.com/v2/online/:id/like

图片列表

  1. GET  https://api.douban.com/v2/online/:id/photos

返回 Photo 列表，具体见相册 Api V2

上传图片

  1. POST  https://api.douban.com/v2/online/:id/photos

具体见相册 Api V2

上线活动论坛发贴

  1. POST  https://api.douban.com/v2/online/:id/discussions|

见论坛 api

获取用户参加的线上活动列表

  1. GET  https://api.douban.com/v2/online/user_participated/:id
参数 意义 备注
exclude_expired 是否包括过期活动 true，false，默认为包含过期

返回：

  1. {
  2.   "start": 0,
  3.   "count": 10,
  4.   "total": 30,
  5.   "onlines": [Online]
  6. }

获取用户创建的线上活动列表

  1. GET  https://api.douban.com/v2/online/user_created/:id

返回Online 列表

线上活动相关错误

错误码 错误信息 含义 status code
1100 begin_time_too_late 开始时间过晚 400
1101 end_time_too_early 结束时间已过 400
1102 end_time_less_than_begin_time 结束时间早于开始时间 400
1103 period_too_long 活动长于 90 天 400
1104 tags_too_much tag 多于 4 个 400
1105 tags_too_long tag 长于 18 个字符 400
1106 edit_too_much 编辑次数过多 400
1107 wrong_cate 错误的列表类别，day，week，latest 分别对应每天，每周，最新 3 个类别 400
1108 wrong_time_format 错误的时间格式，正确时间格式：yyyy-MM-dd HH:mm:ss 400

回 Api V2 首页