有道云笔记 API
概述
数据模型
授权机制
OAuth1.0a授权说明
授权流程
授权请求说明
请求request_token
GET
请求用户登录授权
GET
请求Access Token
GET
OAuth2.0授权说明
OAuth 2.0授权说明
请求用户登陆授权
GET
OAuth1.0a的AccessToken置换成OAuth2.0的AccessToken
GET
用户操作API
查看用户信息
GET
笔记本操作API
查看用户全部笔记本
POST
列出笔记本下的笔记
POST
创建笔记本
POST
删除笔记本
POST
笔记操作API
创建笔记
POST
查看笔记
POST
修改笔记
POST
移动笔记
POST
删除笔记
POST
分享操作API
分享笔记链接
POST
附件操作API
上传附件或图片
POST
下载附件/图片/图标
GET
附录
有道云笔记内容格式
错误码及错误信息说明
OAuth开源类库及有道云笔记SDK
OAuth签名方法
授权流程
创建时间: 2025-06-02 23:15
在获取Consumer Key和Consumer Secret后,应用程序便可以通过OAuth授权访问用户数据,一个完整的OAuth授权流程如下图所示:
图1 OAuth授权流程图
应用程序首先利用Consumer Key与Consumer Secret从有道云笔记Server端获取Request Token及Request Secret。
获取Request Token及Secret后,应用程序便可以将用户重定向至有道云笔记的用户登录授权页面,此时用户登录并选择接受或者拒绝对应用程序的授权,如果用户选择接受授权有道云笔记会重定向至应用程序提供的callback页面,并且将verifier作为参数一同传递过去;如果用户选择拒绝授权则终止整个授权过程。
应用程序利用Request Token以及刚刚得到的verifier应用程序便可以请求Access Token,而有道云笔记在验证过Request Token及verifier后便会生成Access Token及Secret返回给应用程序,之后应用程序便可以使用Access Token及Secret访问用户的数据。通常Access Token具有一定的有效期,在有效期内应用程序可以一直访问该用户的数据,而当Access Token过期后,应用程序则需要再次走一遍授权流程。
在上述过程中,如果发生了任何异常,有道云笔记都会返回对应的错误码及错误信息,详细的错误信息说明见附录B。
最后更新: -