豆瓣日记 API V2

回Api V2 首页

* 注意,日记Api V2都需要登录后才能访问

scope: community_basic_note

增加一篇日记POST/v2/notes
删除一篇日记DELETE/v2/note/:id
更新一篇日记PUT/v2/note/:id
上传照片到日记POST/v2/note/:id
获取一篇日记GET/v2/note/:id
获取日记下的评论列表GET/v2/note/:id/comments
喜欢一篇日记POST/v2/note/:id/like
取消喜欢一篇日记DELETE/v2/note/:id/like
获取用户的日记列表GET/v2/note/user_created/:id

日记 Note

{
    "update_time": "2012-08-20 15:55:20",
    "publish_time": "2012-08-19 01:20:09",
    "photos": {
        "2" : "https://img3.doubanio.com/view/note/large/public/p231928725-2.jpg",
        "3" : "https://img3.doubanio.com/view/note/large/public/p231928725-3.jpg",
        "4" : "https://img3.doubanio.com/view/note/large/public/p231928725-4.jpg",
    },
    "comments_count": 19,
    "liked_count": 67
    "recs_count": 72,
    "id": "231928725",
    "alt": "https://www.douban.com/note/231928725",
    "can_reply": true,
    "title": "《EVA》中现代人的救赎之路 ———论《EVA》中的诺斯替和现代性元素及其他(未完待续)",
    "privacy": "public",
    "summary": "《EVA》中现代人的救赎之路 ———论《EVA》中的诺斯替和现代性元素及其他   这个...",
    "content": "临近20C,当尼采这个狂人宣告上帝已死的时候,现代性才跃出了启蒙思想家的思想图纸,犹如鬼魅一般真正进入了大众民众的日常思想谱系,于是,形式繁多的现代性学说主宰了20C的大众意识形态,无                 论是虚无主义,存在主义,还是马克思主义等等都是现代性语境下的产物。但随着现代性在意识形态的统治地位不断扩张,现代性所引发的病理在21C也愈发彰显。[img=2:C]救赎之路[/img]于是现代性问题成为20C思想界的重要议题,但有两位独树一帜的思想家却引发了我的兴趣,他俩就是约纳斯和沃格林。[img=4:L][/img]沃格林首开先河的提出,基督教早期的异端诺斯替主义像幽灵一样附着于现代性的各种学说之中,并从思想史的角度出发来阐释诺斯替主义和现代性千丝万缕的关系。约纳斯不仅把诺斯替主义看作历史上的一场精神运动,而且进一步把它视为对人类处境的一种独特类型的回应,认为它的思想原则与精神态度普遍地存在于历史的各个阶段。古代的诺斯替宗教..  [url=http://www.douban.com][/url]"
}
字段意义备注
update_time更新时间最后一次编辑的时间
publish_time发布时间
photos日记里的图日记关联的图片
recs_count被推荐的次数
id日记的id
can_reply是否能评论true表示可以评论,false表示不能评论
title日记标题
privacy可见权限public:表示所有人可见 friend:只朋友可见 private:只有自己可见
summary日记简要描述
content日记内容
comment_count评论数
liked_count标记为喜欢数

日记内容格式

使用格式类似BBCode,具体例子如下:

图片[img=id:layout][/img]
带标注的图片[img=id:layout]desc[/img]
url[url="https://www.douban.com"][/url]
带标题的url[url="https://www.douban.com"]豆瓣[/url]

图片格式解释

id图片顺序号,每篇日记内不能重复
layout排版,有L,C,R,分别对应居左,居中,居右3种排版
desc图注,可以为空

获取用户的日记列表

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

请求参数:

format日记内容格式取值为html_full, html_short, abstract, text,默认为text

返回一个Note 列表

获取一条日记

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

请求参数:

format日记内容格式取值为html_full, html_short, abstract, text,默认为text

日记内容格式含义

text默认格式,文本默认,图片和url使用类BBCode标签
html_fullhtml格式的全部内容
html_shorthtml格式的摘要内容
abstract文本格式的摘要内容

返回一个Note

增加一条日记

POST https://api.douban.com/v2/notes

* 如果有图片的话采用multipart/form-data编码方式,上传图片大小限制为<3M,name 是 image_pid

请求参数

名称含义备注示例
title日记标题必传,不能为空
privacy隐私控制为public,friend,private,分布对应公开,朋友可见,仅自己可见
can_reply是否允许回复必传, true或者false
content日记内容, 如果含图片,使用“<图片p_pid>”伪tag引用图片, 如果含链接,使用html的链接标签格式,或者直接使用网址必传日记正文<图片p_2>正文<图片p_3>
pids上传的图片pid本地编号,使用前缀"p_"用逗号分隔,最多一次传3张图片p_2,p_3,p_4
layout_pid对应pid的排版有L, C, R 分别对应居左,居中,居右3种排版
desc_pid对应pid的图注可以为空
image_pid对应pid的图片内容

喜欢一条日记

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

取消喜欢一条日记

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

请求参数

参数意义备注
title日记标题必选参数
content日记内容必选参数
privacy日记可见权限可选参数,默认为public ,对所有人都可见,public:表示所有人可见 friend:只朋友可见 private:只有自己可见
can_reply日记是否可评论可选参数,默认为true ,true表示可以评论,false表示不能评论

返回201,新创建的Note

更新一条日记

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

参数同创建日记一样,成功返回202 ,更新后的Note

上传照片到日记

POST https://api.douban.com/v2/note/:id

* 采用multipart/form-data编码方式,上传图片大小限制为<3M,name 是 image_pid

请求参数

名称含义备注示例
pids上传的图片pid本地编号,使用前缀"p_"用逗号分隔,最多一次传3张图片p_2,p_3,p_4
layout_pid对应pid的排版有L, C, R 分别对应居左,居中,居右3种排版
desc_pid对应pid的图注可以为空
content日记内容, 使用“<图片p_pid>”伪tag引用图片可选,如果不传的话,图片会追加到日记末尾日记正文<图片p_2>正文<图片p_3>
image_pid对应pid的图片内容
//image2.png, image3.png 为本地图片文件路径,curl调用如下,TOKEN为授权后的access_token
curl "https://api.douban.com/v2/note/:id" -H "Authorization: Bearer TOKEN"  -F "pids=p_2,p_3"  -F "image_2=@image2.png" -F "image_3=@image3.png"

返回更新后的日记 Note

删除一条日记

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

删除成功 返回200

日记回复

具体见回复 Api V2

获取讨论回复列表GET/v2/note/:id/comments
回复讨论POST/v2/note/:id/comments
获取讨论单条回复GET/v2/note/:id/comment/:id
删除讨论回复DELETE/v2/note/:id/comment/:id

日记相关错误码

错误码错误信息含义status_code
1006target_not_found找不到某条日记400
1000need_permission没权限访问用户不可见的日记,或者没登录的情况下去访问需要登录的数据403
1002missing_args请求的时候缺少必选的参数400
1014wrong_method错误的http 请求方式,比如一些接口需要http PUT 却用http POST请求400
1001uri_not_found未登录 或者访问的api 没有经过授权申请通过404

回Api V2 首页