豆瓣 API 参考手册

评论

获取评论信息

通过API授权后,才可以获得授权用户自己的评论全文,否则只有摘要。

GET http://api.douban.com/review/{reviewID}

返回值说明

名称 意义 备注
db:subject 评论对应的条目信息 详见条目对应部分
author 评论作者 详见用户对应部分
title 评论标题
updated 更新时间
summary 评论摘要
gd:rating 评论对条目的评分

例如

GET http://api.douban.com/review/1138468

返回评论Entry

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom"
xmlns:gd="http://schemas.google.com/g/2005"
xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/"
xmlns:db="http://www.douban.com/xmlns/">
<db:subject>
    <category scheme="http://www.douban.com/2007#kind"
        term="http://www.douban.com/2007#movie" />
    <author>
        <name>渡边信一郎</name>
    </author>
    <title>Cowboy Bebop</title>
    <summary>
        友情、爱情、廉价道德观,这些都放在一边,享受着朝不保夕的自由人生,以自己的利益为绝对优先的——赏金猎人们,在剧中被称为COWBOY。

        日本动画中一贯会以某 ...
    </summary>
    <link rel="self"
        href="http://api.douban.com/movie/subject/1424406" />
    <link rel="alternate"
        href="http://movie.douban.com/subject/1424406/" />
    <link rel="image"
        href="http://t.douban.com/spic/s2351152.jpg" />
    <db:attribute name="pubdate">1998</db:attribute>
    <db:attribute name="language">日语</db:attribute>
    <db:attribute name="website">
        http://www.cowboybebop.org/
    </db:attribute>
    <db:attribute lang="zh_CN" name="aka">赏金猎人</db:attribute>
    <db:attribute name="imdb">
        http://www.imdb.com/title/tt0213338/
    </db:attribute>
    <db:attribute name="country">Japan</db:attribute>
    <db:attribute name="cast">山寺宏一</db:attribute>
    <db:attribute name="cast">石塚运昇</db:attribute>
    <db:attribute name="cast">林原惠</db:attribute>
    <id>http://api.douban.com/movie/subject/1424406</id>
</db:subject>
<author>
    <link rel="self"
        href="http://api.douban.com/people/iserlohnwind" />
    <link rel="alternate"
        href="http://www.douban.com/people/iserlohnwind/" />
    <link rel="icon" href="http://www.douban.com/icon/u1360856.jpg" />
    <uri>http://api.douban.com/people/iserlohnwind</uri>
    <name>伊谢尔伦的风</name>
</author>
<title>终点之后</title>
<updated>2007-03-27T08:54:43+08:00</updated>
<summary>
    我还是忍不住要说菲。   
    渡边唯一的仁慈,是让小鬼艾德带走了小狗爱因,然后大人们就一步步开始了清醒的葬送:斯派克一往无前义无反顾,杰特明白老搭档的臭脾气所以沉默不语,而当时的菲原本已经是第二次不辞而别——“因为分别太难受了,所以我一个人走了。”《杂烩武士》里15岁的风这样告诉仁和无幻——可又找不到回去的地方,终于还是把自己扔给了BEBOP号,却被告知终曲即将奏响。然而菲不是风,她能悠然对着木乃伊状的伤员剥桔子然后自己吃掉把桔皮留给他,却终不能坦白地承认的自己的不愿别离,不愿被抛下。...
</summary>
<link rel="self" href="http://api.douban.com/review/1138468" />
<link rel="alternate" href="http://www.douban.com/review/1138468/" />
<link rel="http://www.douban.com/2007#subject"
    href="http://api.douban.com/movie/subject/1424406" />
<id>http://api.douban.com/review/1138468</id>
<gd:rating min="1" value="4" max="5" />
</entry>

特定用户的所有评论

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

特定书籍、电影、音乐的所有评论

GET http://api.douban.com/book/subject/{subjectID}/reviews
GET http://api.douban.com/book/subject/isbn/{isbnID}/reviews
GET http://api.douban.com/movie/subject/{subjectID}/reviews
GET http://api.douban.com/movie/subject/imdb/{imdbID}/reviews
GET http://api.douban.com/music/subject/{subjectID}/reviews

请求参数

参数 意义 备注
start-index 起始元素
max-results 返回结果的数量
orderby 排序方式 书影音的所有评论支持该参数
score,按投票排序(默认)
time,按发布时间排序

实例

GET http://api.douban.com/movie/subject/1424406/reviews?start-index=1&max-results=2
GET http://api.douban.com/movie/subject/imdb/tt0213338/reviews?start-index=1&max-results=2

返回结果为一个Feed,包含评论的列表

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:gd="http://schemas.google.com/g/2005"
xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/"
xmlns:db="http://www.douban.com/xmlns/">
<title>Cowboy Bebop 的评论</title>
<opensearch:totalResults>24</opensearch:totalResults>
<link rel="alternate"
    href="http://movie.douban.com/subject/1424406/reviews" />
<opensearch:startIndex>1</opensearch:startIndex>
<entry>
    <updated>2007-03-27T08:54:43+08:00</updated>
    <author>
        <link rel="self"
            href="http://api.douban.com/people/iserlohnwind" />
        <link rel="alternate"
            href="http://www.douban.com/people/iserlohnwind/" />
        <link rel="icon"
            href="http://www.douban.com/icon/u1360856.jpg" />
        <uri>http://api.douban.com/people/iserlohnwind</uri>
        <name>伊谢尔伦的风</name>
    </author>
    <title>终点之后</title>
    <summary>
        我还是忍不住要说菲。   
        渡边唯一的仁慈,是让小鬼艾德带走了小狗爱因,然后大人们就一步步开始了清醒的葬送:斯派克一往无前义无反顾,杰特明白老搭档的臭脾气所以沉默不语,而当时的菲原本已经是第二次不辞而别——“因为分别太难受了,所以我一个人走了。”《杂烩武士》里15岁的风这样告诉仁和无幻——可又找不到回去的地方,终于还是把自己扔给了BEBOP号,却被告知终曲即将奏响。然而菲不是风,她能悠然...
    </summary>
    <link rel="self" href="http://api.douban.com/review/1138468" />
    <link rel="alternate"
        href="http://www.douban.com/review/1138468/" />
    <link rel="http://www.douban.com/2007#subject"
        href="http://api.douban.com/movie/subject/1424406" />
    <id>http://api.douban.com/review/1138468</id>
    <gd:rating min="1" value="4" max="5" />
</entry>
<entry>
    <updated>2007-03-02T20:09:02+08:00</updated>
    <author>
        <link rel="self"
            href="http://api.douban.com/people/iserlohnwind" />
        <link rel="alternate"
            href="http://www.douban.com/people/iserlohnwind/" />
        <link rel="icon"
            href="http://www.douban.com/icon/u1360856.jpg" />
        <uri>http://api.douban.com/people/iserlohnwind</uri>
        <name>伊谢尔伦的风</name>
    </author>
    <title>BEBOP号没有情人节</title>
    <summary>
        http://9.douban.com/site/entry/14995731/
        那个NPC说:菲·瓦伦丁(Faye Valentine),这个名字是我起的,取自情人节(Valentine's
        Day),一年中我最喜欢的节日。
        在民用宇宙飞船BEBOP号,有不加肉的青椒肉丝,有变异到可以跑还能蜇人的松坂牛肉,有龙宫的礼物,有奇妙的蘑菇,有聪明的小狗和四肢像面条的天才儿童……唯独没有情人节。
        ...
    </summary>
    <link rel="self" href="http://api.douban.com/review/1129490" />
    <link rel="alternate"
        href="http://www.douban.com/review/1129490/" />
    <link rel="http://www.douban.com/2007#subject"
        href="http://api.douban.com/movie/subject/1424406" />
    <id>http://api.douban.com/review/1129490</id>
    <gd:rating min="1" value="4" max="5" />
</entry>
<opensearch:itemsPerPage>2</opensearch:itemsPerPage>
</feed>

发布新评论

发布评论必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

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

请求为一个Entry

请求数据说明

名称 意义 备注
db:subject 评论对应的条目id
title 评论标题
content 评论内容, 评论正文字数不得少于150个字
gd:rating 评论对条目的评分 5分制
<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns:ns0="http://www.w3.org/2005/Atom">
<db:subject xmlns:db="http://www.douban.com/xmlns/">
    <id>http://api.douban.com/movie/subject/1424406</id>
</db:subject>
<content>
    渡边唯一的仁慈,是让小鬼艾德带走了小狗爱因,然后大人们就一步步开始了清醒的葬送:斯派克一往无前义无反顾,杰特明白老搭档的臭脾气所以沉默不语,而当时的菲原本已经是第二次不辞而别——“因为分别太难受了,所以我一个人走了。”《杂烩武士》里15岁的风这样告诉仁和无幻——可又找不到回去的地方,终于还是把自己扔给了BEBOP号,却被告知终曲即将奏响。然而菲不是风,她能悠然对着木乃伊状的伤员剥桔子然后自己吃掉把桔皮留给他,却终不能坦白地承认的自己的不愿别离,不愿被抛下。...
</content>
<gd:rating xmlns:gd="http://schemas.google.com/g/2005" value="4" ></gd:rating>
<title>终点之后</title>
</entry>
        

成功返回

201 CREATED

修改评论

修改评论必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

PUT http://api.douban.com/review/{reviewID}

实例

PUT http://api.douban.com/review/1138468

请求为一个Entry

<?xml version='1.0' encoding='UTF-8'?>
<entry xmlns:ns0="http://www.w3.org/2005/Atom">
<id>http://api.douban.com/review/1138468</id>
<db:subject xmlns:db="http://www.douban.com/xmlns/">
<id>http://api.douban.com/movie/subject/1424406</id>
</db:subject>
<content>
渡边唯一的仁慈,是让小鬼艾德带走了小狗爱因,然后大人们就一步步开始了清醒的葬送:斯派克一往无前义无反顾,杰特明白老搭档的臭脾气所以沉默不语,而当时的菲原本已经是第二次不辞而别——“因为分别太难受了,所以我一个人走了。”《杂烩武士》里15岁的风这样告诉仁和无幻——可又找不到回去的地方,终于还是把自己扔给了BEBOP号,却被告知终曲即将奏响。然而菲不是风,她能悠然对着木乃伊状的伤员剥桔子然后自己吃掉把桔皮留给他,却终不能坦白地承认的自己的不愿别离,不愿被抛下。...
</content>
<gd:rating xmlns:gd="http://schemas.google.com/g/2005" value="4" ></gd:rating>
<title>终点之后</title>
</entry>
        

成功返回

202 Accepted

删除评论

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

DELETE http://api.douban.com/review/{reviewID}

实例

DELETE http://api.douban.com/review/1138468

成功返回

200 OK