豆瓣 API 参考手册

日记

获取日记

通过API授权后,根据授权用户的身份,可以获得用户仅对朋友可见和仅对自己可见的日记

API根据用户的设置来确定输出全文或摘要

  • 设置为输出全文,summary元素里给出摘要,content元素给出原文
  • 设置为输出摘要,summary和content元素一致,都给出摘要
  • 通过API授权后,对于授权用户自己的日记,一定输出全文
GET http://api.douban.com/note/{noteID}

例如

GET http://api.douban.com/note/8001851

返回格式

<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/note/8001851</id>
<title>ABOUT ME</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-26.jpg" rel="icon"/>
<name>胖胖的大头鱼大头鱼大头鱼大头鱼</name>
<uri>http://api.douban.com/people/1057620</uri>
</author>
<published>2008-08-15T16:32:20+08:00</published>
<updated>2008-08-15T16:32:20+08:00</updated>
<link href="http://api.douban.com/note/8001851" rel="self"/>
<link href="http://www.douban.com/note/8001851/" rel="alternate"/>
<summary>在失去勇气的日子里,要提醒自己的好!  我从来不寻找任何避风港,20多年的日子里每个选择都来自我自己,我比你们想象的都要坚强。我为我的坚强付出了很多,却到现在依然没有后悔过任何。 我从不觉得牺牲自己是件多伟大的事,没有人是需要别人来成全的,从来不想以自己的付出作为最后的救命稻草,这种付出委实是在出卖尊严.......</summary>
<content>在失去勇气的日子里,要提醒自己的好!  我从来不寻找任何避风港,20多年的日子里每个选择都来自我自己,我比你们想象的都要坚强。我为我的坚强付出了很多,却到现在依然没有后悔过任何。 我从不觉得牺牲自己是件多伟大的事,没有人是需要别人来成全的,从来不想以自己的付出作为最后的救命稻草,这种付出委实是在出卖尊严.......</content>
<db:attribute name="privacy">public</db:attribute>
<db:attribute name="can_reply">yes</db:attribute>
</entry>

获取用户的所有日记

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

请求参数

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

例如

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

返回格式

<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-26.jpg" rel="icon"/>
<name>胖胖的大头鱼大头鱼大头鱼大头鱼</name>
<uri>http://api.douban.com/people/1057620</uri>
</author>
<link href="http://www.douban.com/people/aka/notes" rel="alternate"/>
<opensearch:startIndex>1</opensearch:startIndex>
<opensearch:itemsPerPage>1</opensearch:itemsPerPage>
<entry>
<id>http://api.douban.com/note/8001851</id>
<title>ABOUT ME</title>
<published>2008-08-15T16:32:20+08:00</published>
<updated>2008-08-15T16:32:20+08:00</updated>
<link href="http://api.douban.com/note/8001851" rel="self"/>
<link href="http://www.douban.com/note/8001851/" rel="alternate"/>
<summary>在失去勇气的日子里,要提醒自己的好!  我从来不寻找任何避风港,20多年的日子里每个选择都来自我自己,我比你们想象的都要坚强。我为我的坚强付出了很多,却到现在依然没有后悔过任何。 我从不觉得牺牲自己是件多伟大的事,没有人是需要别人来成全的,从来不想以自己的付出作为最后的救命稻草,这种付出委实是在出卖尊严.......</summary>
<content>在失去勇气的日子里,要提醒自己的好!  我从来不寻找任何避风港,20多年的日子里每个选择都来自我自己,我比你们想象的都要坚强。我为我的坚强付出了很多,却到现在依然没有后悔过任何。 我从不觉得牺牲自己是件多伟大的事,没有人是需要别人来成全的,从来不想以自己的付出作为最后的救命稻草,这种付出委实是在出卖尊严.......</content>
<db:attribute name="privacy">public</db:attribute>
<db:attribute name="can_reply">yes</db:attribute>
</entry>
</feed>
    

发表新日记

发表新日记必须先进行API认证授权,关于API认证授权的信息请参阅API 授权说明

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

实例

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

请求为一个Entry

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom"
xmlns:db="http://www.douban.com/xmlns/">
<title>ABOUT ME</title>
<content>
        在失去勇气的日子里,要提醒自己的好!  我从来不寻找任何避风港,20多年的日子里每个选择都来自我自己,我比你们想象的都要坚强。我为我的坚强付出了很多,却到现在依然没有后悔过任何。 我从不觉得牺牲自己是件多伟大的事,没有人是需要别人来成全的,从来不想以自己的付出作为最后的救命稻草,这种付出委实是在出卖尊严......
</content>
<db:attribute name="privacy">private</db:attribute>
<db:attribute name="can_reply">yes</db:attribute>
</entry>

成功返回

201 CREATED

更新日记

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

PUT http://api.douban.com/note/{noteID}

实例

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

请求为一个Entry

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom"
xmlns:db="http://www.douban.com/xmlns/">
<title>ABOUT ME</title>
<content>
        在失去勇气的日子里,要提醒自己的好!  我从来不寻找任何避风港,20多年的日子里每个选择都来自我自己,我比你们想象的都要坚强。我为我的坚强付出了很多,却到现在依然没有后悔过任何。 我从不觉得牺牲自己是件多伟大的事,没有人是需要别人来成全的,从来不想以自己的付出作为最后的救命稻草,这种付出委实是在出卖尊严......
</content>
<db:attribute name="privacy">private</db:attribute>
<db:attribute name="can_reply">yes</db:attribute>
</entry>

成功返回

202 ACCEPTED

删除日记

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

DELETE http://api.douban.com/note/{noteID}

实例

DELETE http://api.douban.com/note/8001851

成功返回

200 OK