豆瓣线上活动 API V2

回Api V2 首页

scope: community_basic_online

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

scope: community_advanced_online

创建线上活动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

{
    "id":"11038343",
    "alt":"http://www.douban.com/online/11038343/",

    "title":"新的截图猜电影,来!",
    "desc":"截图猜电影\r\n猜中后描述改为:\r\n《电影名》 by (猜中者名字)\r\n请遵守规则!\r\n\r\n附注:相关网址是,听>配乐>猜电影友情活动,尽请参加!",

    "tags":["截图", "电影", "交友", "猜图"],

    "created":"2012-02-24 11:49:32",
    "begin_time":"2012-02-24 11:00:00",
    "end_time":"2012-05-23 11:00:00",

    "related_url":"http://www.douban.com/online/10999361/",
    "shuo_topic":"新的截图猜电影,来!", //对应广播的#主题#
    "cascade_invite":true, //用户能不能邀请友邻加入
    "group_id":"0", //关联小组的id
    "album_id":"65606728", //对应相册的id

    "participant_count":13881, //参加人数
    "photo_count":63281, //照片数
    "liked_count":2127, //喜欢数
    "recs_count":417, //推荐数

    "icon":"http://img1.douban.com/bpic/o590273.jpg",
    "thumb":"http://img1.douban.com/spic/o590273.jpg",
    "cover":"http://img1.douban.com/tpic/o590273.jpg",
    "image":"http://img1.douban.com/lpic/o590273.jpg",

    "owner": User,
    //当前用户是否喜欢,参加
    "liked": false,
    "joined": false,
}

获取线上活动

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

返回 Online

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

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

返回 User 列表

获取线上活动论坛列表

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

返回 Discussion 列表

获取线上活动列表

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

返回 Online 列表

创建线上活动

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

更新线上活动

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

参数参考创建线上活动

删除线上活动

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

参加线上活动

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

退出线上活动

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

喜欢线上活动

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

取消喜欢线上活动

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

图片列表

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

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

上传图片

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

具体见相册 Api V2

上线活动论坛发贴

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

论坛 api

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

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

返回:

{
    "start": 0,
    "count": 10,
    "total": 30,
    "onlines" : [Online, ]
}

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

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

返回Online 列表

线上活动相关错误

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

回Api V2 首页