豆瓣日记 API V2

回 Api V2 首页

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

scope: community_basic_note

name Method endpoint
增加一篇日记 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

  1. {
  2. "update_time": "2012-08-20 15:55:20",
  3. "publish_time": "2012-08-19 01:20:09",
  4. "photos": {
  5. "2" : "http://img6.douban.com/view/note/large/public/p231928725-2.jpg",
  6. "3" : "http://img6.douban.com/view/note/large/public/p231928725-3.jpg",
  7. "4" : "http://img6.douban.com/view/note/large/public/p231928725-4.jpg",
  8. },
  9. "comments_count": 19,
  10. "liked_count": 67
  11. "recs_count": 72,
  12. "id": "231928725",
  13. "alt": "http://www.douban.com/note/231928725",
  14. "can_reply": true,
  15. "title": "《EVA》中现代人的救赎之路 ———论《EVA》中的诺斯替和现代性元素及其他(未完待续)",
  16. "privacy": "public",
  17. "summary": "《EVA》中现代人的救赎之路 ———论《EVA》中的诺斯替和现代性元素及其他 这个...",
  18. "content": "临近20C,当尼采这个狂人宣告上帝已死的时候,现代性才跃出了启蒙思想家的思想图纸,犹如鬼魅一般真正进入了大众民众的日常思想谱系,于是,形式繁多的现代性学说主宰了20C的大众意识形态,无 论是虚无主义,存在主义,还是马克思主义等等都是现代性语境下的产物。但随着现代性在意识形态的统治地位不断扩张,现代性所引发的病理在21C也愈发彰显。[img=2:C]救赎之路[/img]于是现代性问题成为20C思想界的重要议题,但有两位独树一帜的思想家却引发了我的兴趣,他俩就是约纳斯和沃格林。[img=4:L][/img]沃格林首开先河的提出,基督教早期的异端诺斯替主义像幽灵一样附着于现代性的各种学说之中,并从思想史的角度出发来阐释诺斯替主义和现代性千丝万缕的关系。约纳斯不仅把诺斯替主义看作历史上的一场精神运动,而且进一步把它视为对人类处境的一种独特类型的回应,认为它的思想原则与精神态度普遍地存在于历史的各个阶段。古代的诺斯替宗教.. [url=http://www.douban.com][/url]"
  19. }
字段 意义 备注
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=”http://www.douban.com"][/url]
带标题的 url [url=”http://www.douban.com"]豆瓣[/url]

图片格式解释

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

获取用户的日记列表

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

请求参数:

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

返回一个Note 列表

获取一条日记

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

请求参数:

参数 描述 可选值
format 日记内容格式 取值为 html_full, html_short, abstract, text,默认为 text

日记内容格式含义

格式 描述
text 默认格式,文本默认,图片和 url 使用类 BBCode 标签
html_full html 格式的全部内容
html_short html 格式的摘要内容
abstract 文本格式的摘要内容

返回一个Note

增加一条日记

  1. 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 的图片内容

喜欢一条日记

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

取消喜欢一条日记

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

请求参数

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

返回 201,新创建的Note

更新一条日记

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

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

上传照片到日记

  1. 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 的图片内容
  1. //image2.png, image3.png 为本地图片文件路径,curl调用如下,TOKEN为授权后的access_token
  2. 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

删除一条日记

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

删除成功 返回 200

日记回复

具体见回复 Api V2

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

日记相关错误码

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

回 Api V2 首页