豆瓣 API 参考手册

活动

获取活动

通过API授权后,对于授权用户自己创建的活动,输出活动介绍的全文;其他情况输出活动介绍的摘要

  • 输出全文时,summary元素里给出摘要,content元素给出原文
  • 输出摘要时,summary和content元素一致,都给出摘要
GET http://api.douban.com/event/{eventID}

例如

GET http://api.douban.com/event/10069638

返回格式

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
<id>http://api.douban.com/event/10069638</id>
<title>Debugging the Web </title>
<category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#event.salon"/>
<author>
<link href="http://api.douban.com/people/1057620" rel="self"/>
<link href="http://www.douban.com/people/aka/" rel="alternate"/>
<link href="http://t.douban.com/icon/u1057620-16.jpg" rel="icon"/>

<name>胖胖的大头鱼</name>
<uri>http://api.douban.com/people/1057620</uri>
</author>
<link href="http://api.douban.com/event/10069638" rel="self"/>
<link href="http://www.douban.com/event/10069638/" rel="alternate"/>
<summary>著名的开源人物David Baron近期再次来华,并安排本周日在清华FIT楼以 “Debugging the Web:looking at Web sites that don’t work correctly in Firefox, and how they can be fixed”的题目与社区和广大爱好者交流,特别欢迎学生参加。地址选在FIT为了方 便,所有人都欢迎。

Mozilla 技术讲座

===============

时间:2008年4月20日(...</summary>
<content>著名的开源人物David Baron近期再次来华,并安排本周日在清华FIT楼以 “Debugging the Web:looking at Web sites that don’t work correctly in Firefox, and how they can be fixed”的题目与社区和广大爱好者交流,特别欢迎学生参加。地址选在FIT为了方 便,所有人都欢迎。

Mozilla 技术讲座

===============

时间:2008年4月20日(...</content>
<db:attribute name="invite_only">no</db:attribute>

<db:attribute name="can_invite">no</db:attribute>
<db:attribute name="participants">3</db:attribute>
<db:attribute name="wishers">10</db:attribute>
<db:attribute name="status">participant</db:attribute>
<db:location id="beijing">北京</db:location>
<gd:when endTime="2008-04-20T16:30:00+08:00" startTime="2008-04-20T14:00:00+08:00"/>
<gd:where valueString="北京 清华大学东门FIT楼二层多功能厅"/>
</entry>
    

获取参加活动的用户

GET http://api.douban.com/event/{eventID}/participants

获取活动感兴趣的用户

GET http://api.douban.com/event/{eventID}/wishers

请求参数

参数 意义 备注
start-index 起始元素
max-results 返回结果的数量

例如

GET http://api.douban.com/event/10069638/wishers?start-index=5&max-results=1

返回格式

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
<title>对 Debugging the Web  活动感兴趣的成员</title>
<opensearch:startIndex>5</opensearch:startIndex>
<opensearch:itemPerPage>1</opensearch:itemPerPage>
<opensearch:totalResults>10</opensearch:totalResults>
<entry>
<id>http://api.douban.com/people/2063070</id>
<title>mona</title>
<link href="http://api.douban.com/people/2063070" rel="self"/>
<link href="http://www.douban.com/people/2063070/" rel="alternate"/>
<link href="http://t.douban.com/icon/u2063070-1.jpg" rel="icon"/>
<link href="http://hi.baidu.com/duanmengnan" rel="homepage"/>
<content></content>
<db:location id="beijing">北京</db:location>
<db:uid>2063070</db:uid>

</entry>
</feed>

获取用户的所有活动

GET http://api.douban.com/people/{userID}/events

请求参数

参数 意义 备注
start-index 起始元素
max-results 返回结果的数量

例如

GET http://api.douban.com/people/aka/events?start-index=3&max-results=1

返回格式

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
<title>胖胖的大头鱼的活动</title>
<author>
<link href="http://api.douban.com/people/1057620" rel="self"/>
<link href="http://www.douban.com/people/aka/" rel="alternate"/>
<link href="http://t.douban.com/icon/u1057620-16.jpg" rel="icon"/>
<name>胖胖的大头鱼</name>
<uri>http://api.douban.com/people/1057620</uri>
</author>
<link href="http://www.douban.com/people/1057620/events" rel="alternate"/>
<opensearch:startIndex>3</opensearch:startIndex>
<opensearch:itemPerPage>1</opensearch:itemPerPage>
<opensearch:totalResults>46</opensearch:totalResults>
<entry>
<id>http://api.douban.com/event/10297336</id>
<title>Open Source Camp 北京 2008技术交流盛会</title>
<category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#event.salon"/>
<author>
    <link href="http://api.douban.com/people/1000062" rel="self"/>
    <link href="http://www.douban.com/people/shizhao/" rel="alternate"/>
    <link href="http://t.douban.com/icon/u1000062-1.jpg" rel="icon"/>
    <name>shizhao</name>
    <uri>http://api.douban.com/people/1000062</uri>
</author>
<link href="http://api.douban.com/event/10297336" rel="self"/>
<link href="http://www.douban.com/event/10297336/" rel="alternate"/>
<link href="http://t.douban.com/mpic/e39902.jpg" rel="image"/>
<summary>更多信息,请访问:http://www.opensourcecamp.org/ , http://www.opensourcecamp.org.cn/
OSCAMP@Facebook:http://www.new.facebook.com/home.php#/group.php?gid=5626789741

活动联系人

Peter Cheng 138-1138-1302 opensourcecamp@gmail.com
如何报名参加

如果你想参加OpenSourceCamp 北京活动,请填写在线的报名表格:https://sp...</summary>
<content>更多信息,请访问:http://www.opensourcecamp.org/ , http://www.opensourcecamp.org.cn/
OSCAMP@Facebook:http://www.new.facebook.com/home.php#/group.php?gid=5626789741

活动联系人

Peter Cheng 138-1138-1302 opensourcecamp@gmail.com
如何报名参加

如果你想参加OpenSourceCamp 北京活动,请填写在线的报名表格:https://sp...</content>
<db:attribute name="invite_only">no</db:attribute>
<db:attribute name="can_invite">yes</db:attribute>
<db:attribute name="participants">13</db:attribute>
<db:attribute name="wishers">22</db:attribute>
<db:attribute name="status">wish</db:attribute>
<db:location id="beijing">北京</db:location>
<gd:when endTime="2008-10-25T19:00:00+08:00" startTime="2008-10-25T13:00:00+08:00"/>
<gd:where valueString="北京 海淀区蓝旗营路北 工商银行旁 Study 英语学 习吧(三角地)"/>
</entry>
</feed>
    

获取用户发起/参加/感兴趣的所有活动

GET http://api.douban.com/people/{userID}/events/initiate
GET http://api.douban.com/people/{userID}/events/participate
GET http://api.douban.com/people/{userID}/events/wish

请求参数

参数 意义 备注
start-index 起始元素
max-results 返回结果的数量

例如

GET http://api.douban.com/people/aka/events/initiate?start-index=3&max-results=1

返回格式

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
<title>胖胖的大头鱼发起的活动</title>
<author>
<link href="http://api.douban.com/people/1057620" rel="self"/>
<link href="http://www.douban.com/people/aka/" rel="alternate"/>
<link href="http://t.douban.com/icon/u1057620-16.jpg" rel="icon"/>
<name>胖胖的大头鱼</name>
<uri>http://api.douban.com/people/1057620</uri>

</author>
<link href="http://www.douban.com/people/1057620/events" rel="alternate"/>
<opensearch:startIndex>1</opensearch:startIndex>
<opensearch:itemPerPage>1</opensearch:itemPerPage>
<entry>
<id>http://api.douban.com/event/10247550</id>
<title>GNOME.Asia Summit</title>
<category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#event.salon"/>
<author>
    <link href="http://api.douban.com/people/1057620" rel="self"/>
    <link href="http://www.douban.com/people/aka/" rel="alternate"/>
    <link href="http://t.douban.com/icon/u1057620-16.jpg" rel="icon"/>
    <name>胖胖的大头鱼</name>
    <uri>http://api.douban.com/people/1057620</uri>
</author>
<link href="http://api.douban.com/event/10247550" rel="self"/>
<link href="http://www.douban.com/event/10247550/" rel="alternate"/>
<link href="http://t.douban.com/mpic/e39143.jpg" rel="image"/>
<summary>The GNOME.Asia Summit will be focus primarily on the GNOME desktop, applications, development platform, and the larger GNOME-related community in Asia. It will bring together the GNOME-related community all over Asia providing a forum for GNOME users, developers, foundation leaders, individuals, governments and busines...</summary>
<content>The GNOME.Asia Summit will be focus primarily on the GNOME desktop, applications, development platform, and the larger GNOME-related community in Asia. It will bring together the GNOME-related community all over Asia providing a forum for GNOME users, developers, foundation leaders, individuals, governments and busines...</content>
<db:attribute name="invite_only">no</db:attribute>
<db:attribute name="can_invite">yes</db:attribute>
<db:attribute name="participants">26</db:attribute>
<db:attribute name="wishers">18</db:attribute>
<db:attribute name="status">participant</db:attribute>
<db:location id="beijing">北京</db:location>
<gd:when endTime="2008-10-19T18:00:00+08:00" startTime="2008-10-18T09:00:00+08:00"/>
<gd:where valueString="北京 北航 新主楼会议中心"/>
</entry>

获取城市的所有活动

GET http://api.douban.com/event/location/{locationID}

请求参数

参数 意义 备注
type 活动类型 all, commonweal, drama, exhibition, film, music, others, party, salon, sports, travel. 可选参数,默认为all
start-index 起始元素
max-results 返回结果的数量

例如

GET http://api.douban.com/event/location/beijing?start-index=1&max-results=1

返回格式

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
<title>豆瓣同城 北京 的活动</title>
<opensearch:startIndex>1</opensearch:startIndex>
<opensearch:itemPerPage>1</opensearch:itemPerPage>
<opensearch:totalResults>983</opensearch:totalResults>
<entry>
<id>http://api.douban.com/event/10082084</id>

<title>去坐世界最大的摩天轮吧</title>
<category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#event.party"/>
<link href="http://api.douban.com/event/10082084" rel="self"/>
<link href="http://www.douban.com/event/10082084/" rel="alternate"/>
<link href="http://t.douban.com/mpic/e18285.jpg" rel="image"/>
<summary>据说是奥运之前会建好
好吧,正好我过两个月才回来
到时候应该建成了吧

对摩天轮有执念

摩天轮
适合告白
我完美的自杀地

对于这个不靠谱的活动
因为客观原因时间与实际时间不符合
就这样拖着吧
2010年是么……

真悲伤</summary>
<content>据说是奥运之前会建好
好吧,正好我过两个月才回来
到时候应该建成了吧

对摩天轮有执念

摩天轮
适合告白
我完美的自杀地

对于这个不靠谱的活动
因为客观原因时间与实际时间不符合
就这样拖着吧
2010年是么……

真悲伤</content>
<db:attribute name="invite_only">no</db:attribute>

<db:attribute name="can_invite">yes</db:attribute>
<db:attribute name="participants">2080</db:attribute>
<db:attribute name="wishers">2726</db:attribute>
<db:attribute name="status">initiate</db:attribute>
<db:location id="beijing">北京</db:location>
<gd:when endTime="2008-12-25T21:00:00+08:00" startTime="2008-10-01T21:00:00+08:00"/>

<gd:where valueString="北京 朝阳公园"/>
</entry>
</feed>
    

搜索活动

GET http://api.douban.com/events

请求参数

参数 意义 备注
q 全文检索的关键词
location 城市id 必选参数,all为搜索所有城市活动
start-index 起始元素
max-results 返回结果的数量

例如

GET http://api.douban.com/events?q=秋天&location=beijing&start-index=2&max-results=1
    

返回结果为一个Feed,包含活动的列表

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
<title>豆瓣同城北京活动搜索 秋天 的结果</title>
<opensearch:startIndex>2</opensearch:startIndex>
<opensearch:itemPerPage>1</opensearch:itemPerPage>
<opensearch:totalResults>27</opensearch:totalResults>
<entry>
<id>http://api.douban.com/event/10138765</id>

<title>非常摇滚音乐网 非常现场系列之 — 秋天的虫子复出专场</title>
<category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#event.music"/>
<link href="http://api.douban.com/event/10138765" rel="self"/>
<link href="http://www.douban.com/event/10138765/" rel="alternate"/>
<link href="http://t.douban.com/mpic/e26877.jpg" rel="image"/>
<summary>非常摇滚音乐网 非常现场系列之

声声不息 秋虫十年 — 秋天的虫子复出专场

今晚的狂欢属于品尝过流血的你们,今晚将属于婚姻幸福,属于相见恨晚,属于过眼云烟,属于 唇亡齿寒。让我们谈谈压迫和反抗,谈谈时光,互拼酒量,让我们回避眼泪,回避恐惧,让夜色 掩饰伤痕。你的羽翼已经丰满,这一天早该到了,早该飞了,只是此刻才展开翅膀,此...</summary>
<content>非常摇滚音乐网 非常现场系列之

声声不息 秋虫十年 — 秋天的虫子复出专场

今晚的狂欢属于品尝过流血的你们,今晚将属于婚姻幸福,属于相见恨晚,属于过眼云烟,属于 唇亡齿寒。让我们谈谈压迫和反抗,谈谈时光,互拼酒量,让我们回避眼泪,回避恐惧,让夜色 掩饰伤痕。你的羽翼已经丰满,这一天早该到了,早该飞了,只是此刻才展开翅膀,此...</content>
<db:attribute name="invite_only">no</db:attribute>

<db:attribute name="can_invite">no</db:attribute>
<db:attribute name="participants">459</db:attribute>
<db:attribute name="wishers">123</db:attribute>
<db:attribute name="status">initiate</db:attribute>
<db:location id="beijing">北京</db:location>
<gd:when endTime="2008-07-25T22:00:00+08:00" startTime="2008-06-16T20:00:00+08:00"/>
<gd:where valueString="北京 Mao live House"/>
</entry>
</feed>
    

创建新活动

创建新活动必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

POST http://api.douban.com/events

实例

POST http://api.douban.com/events

请求为一个Entry(用户只能创建自己所在城市的活动,若用户不在任何城市,不能创建活动)

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
<title>Comme des Garçons 展览会 </title>
<category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#event.exhibit"/>
<content>在成功举办 Maison Martin Margiela北京展览会之后,著名香港时装集团 I.T在>北京798艺术区再度隆重推介 Comme des Garçons展览会。这是继今年4月于北京金融街(000402,>股吧)购物中心为 Comme des Garçons开设中国内地首家专门店后,I.T推动该品牌 与中国文化交>流的又一次大动作。 

川久保玲的重要贡献,不仅是她的品牌Comme des Garçons,更是她提携的众多日本设计师如渡边
淳弥、高桥盾和粟原TAO等,而她在理念上的领先也许才是一切的根源。Fashion最终是要卖产品>的,而店铺则是达成交易的场所,最擅长玩游击店、限定展览的川久保玲,今次将艺术场地空运>抵京。 


此次展览信息如下: 

Comme des Garçons展览会 

2008年7月16日-9月30日 - 早上11时至晚上7时 -星期一休馆 

I.T 

大山子798艺术区 

北京市朝阳区酒仙桥路2号 706北一街 B07展馆 

相关贴图请留意:http://www.hfou.net/index.php?action-viewnews-itemid-9547-php-1</content>

<db:attribute name="invite_only">no</db:attribute>
<db:attribute name="can_invite">yes</db:attribute>
<gd:when endTime="2008-09-30T19:00:00+08:00" startTime="2008-07-16T11:00:00+08:00"/>
<gd:where valueString="大山子798艺术区 IT馆"/>
</entry>

成功返回

201 CREATED

参加活动

参加活动必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

POST http://api.douban.com/event/{eventID}/participants

对活动感兴趣

对活动感兴趣必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

POST http://api.douban.com/event/{eventID}/wishers

实例

POST http://api.douban.com/event/10082084/wishers

成功返回

201 CREATED

不参加活动了

不参加活动必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

DELETE http://api.douban.com/event/{eventID}/participants

对活动不感兴趣

对活动不感兴趣必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

DELETE http://api.douban.com/event/{eventID}/wishers

实例

DELETE http://api.douban.com/event/10082084/wishers

成功返回

200 OK

更新活动

更新活动信息必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

过期活动不能更新

PUT http://api.douban.com/event/{eventID}

实例

PUT http://api.douban.com/event/8001851

请求为一个Entry

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
<title>Comme des Garçons 展览会 </title>
<category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#event.exhibit"/>
<content>在成功举办 Maison Martin Margiela北京展览会之后,著名香港时装集团 I.T在>北京798艺术区再度隆重推介 Comme des Garçons展览会。这是继今年4月于北京金融街(000402,>股吧)购物中心为 Comme des Garçons开设中国内地首家专门店后,I.T推动该品牌 与中国文化交>流的又一次大动作。 

川久保玲的重要贡献,不仅是她的品牌Comme des Garçons,更是她提携的众多日本设计师如渡边
淳弥、高桥盾和粟原TAO等,而她在理念上的领先也许才是一切的根源。Fashion最终是要卖产品>的,而店铺则是达成交易的场所,最擅长玩游击店、限定展览的川久保玲,今次将艺术场地空运>抵京。 


此次展览信息如下: 

Comme des Garçons展览会 

2008年7月16日-9月30日 - 早上11时至晚上7时 -星期一休馆 

I.T 

大山子798艺术区 

北京市朝阳区酒仙桥路2号 706北一街 B07展馆 

相关贴图请留意:http://www.hfou.net/index.php?action-viewnews-itemid-9547-php-1</content>

<db:attribute name="invite_only">no</db:attribute>
<db:attribute name="can_invite">yes</db:attribute>
<gd:when endTime="2008-09-30T19:00:00+08:00" startTime="2008-07-16T11:00:00+08:00"/>
<gd:where valueString="大山子798艺术区 IT馆"/>
</entry>

成功返回

200 ACCEPTED

删除活动

删除活动必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

注意: 删除活动的时候需要提交一个删除的原因,所以删除的时候并不是发一个DELETE到活动的URI,而是将原因POST到另一个URI

POST http://api.douban.com/event/{eventID}/delete

实例

POST http://api.douban.com/event/8001851/delete

请求为一个Entry

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns:ns0="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/">
<content>对不起大家,活动因故取消了</content>
</entry>
        

成功返回

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns:ns0="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/">
<result>OK</result>
</entry>