豆邮Api V2

回Api V2 首页

  • 豆瓣Api V2 需要授权后才能访问

scope: community_advanced_doumail_r

获取一封邮件GET/v2/doumail/:id
获取用户的收件箱GET/v2/doumail/inbox
获取用户的发件箱GET/v2/doumail/outbox
获取用户的未读邮件列表GET/v2/doumail/inbox/unread

scope: community_advanced_doumail_w

发送一封豆邮POST/v2/doumails
标记已读一封邮件PUT/v2/doumail/:id
批量标记已读邮件PUT/v2/doumail/read
删除一封邮件DELETE/v2/doumail/:id
批量删除邮件POST/v2/doumail/delete

豆邮 Doumail

{
    "status": "R",   
    "id: "256444525",
    "sender": User,
    "receiver": User,
    "title": "你好,我们是电影《二次曝光》,【二次曝光】豆瓣官方小站期待您的关注,时刻都有惊喜带给您!",
    "published": "2012-07-31 12:40:04",
    "content": "  你是否曾深爱过一个人? 
   你是否有过一段深爱的恋情? 
   你是否有个爱恨交织难舍难分的挚友? 
   你是否…… 
   这是我们的故事,是电影《二次曝光》的故事,也是你的故事。 
    "
}
字段意义备注
status邮件的状态U:表示这封邮还未读 R:表示已读
sender发件人信息
receiver接收人信息
published发送邮件时间
content邮件正文
total邮件总条数
id邮件id

获取一封豆邮

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

请求参数

参数意义备注
keep-unread是否保持未读状态可选参数, true 请求一封豆邮件状态还是未读,false 改变状态为已读,默认为false

返回一个Doumail

获取用户收件箱

GET https://api.douban.com/v2/doumail/inbox

返回一个 Doumail 列表

获取用户发件箱

GET https://api.douban.com/v2/doumail/outbox

返回一个 doumail list

获取用户未读邮件

GET https://api.douban.com/v2/doumail/inbox/unread

返回一个 doumail list

标记已读一封邮件

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

返回doumail, http status 202

批量标记豆邮为已读

PUT https://api.douban.com/v2/doumail/read

请求参数

参数意义备注
ids需要标记为已读的豆邮id必选参数 每个id 用 ","号隔开 比如 "258003077,25800385,34938344,"

返回一个 doumail list , http status 202

删除一封豆邮

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

删除成功http status 200

批量删除豆邮

POST https://api.douban.com/v2/doumail/delete

请求参数

参数意义备注
ids需要删除的豆邮id必选参数 每个id 用 ","号隔开 比如 "258003077,25800385,34938344,"

发送一封豆邮

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

请求参数

参数意义备注
title豆邮标题必填字段
content豆邮正文必填字段
receiver_id接收邮件的用户id必填字段
captcha_token系统验证码 token选填字段
captcha_string用户输入验证码选填字段

邮件发送成功 http status 返回 201, 返回 {}

当用户发送邮件过于频繁,http status 返回 403 ,并且返回

{        
    "captcha_token":"PT5ip6fBKE3g5RfgLnNkbRRK",         

    "captcha_url":"http://www.douban.com/misc/captcha?id=PT5ip6fBKE3g5RfgLnNkbRRK&size=s"
}
captcha_url验证码图片的url
captcha_token再次提交时需要加的token
captcha_string再次提交时需要加用户输入的验证码字符串

* 用户输入图片所显示的验证码 ,再请求一次发送豆邮接口,系统验证码验证通过后 则能够正常的发送成功,否则继续返回 captch_token和captcha_url

豆邮错误码

错误码错误信息含义status_code
1006target_not_found找不到对应 id的豆邮400
1000need_permission没权限访问用户的豆邮数据403
1002missing_args请求的时候缺少必选的参数400
1014invalid_request_uri错误的http 请求方式,比如一些接口需要http PUT 却用http POST请求400
1001uri_not_found未登录 或者访问的api 没有经过授权申请通过404
1107wrong_cate批量更新邮件为已读失败400