豆瓣 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

> 回到参考手册目录