有道云笔记 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

在进行OAuth授权请求时,OAuth相关的参数可以放置在query string和http header中,这里我们推荐使用http header的方式,这样可以将OAuth相关的参数与接口非OAuth参数区别对待,其中Header name为Authorization,而Header value则为OAuth相关参数组成的值,格式如下:

OAuth[空格][parameterName=”value”],[空格][ parameterName=”value”]…此外在发送时还有以下几点需要注意:

  1. parameterName和value必须进行Percent Encoding (做法为先进行URL Encoding后再要将”+”替换为”%20”,将”*”替换为”%2A”,将”%7E”替换为”~”)
  2. value的引号为必须
  3. 发送请求时参数可以是无序的,但是在签名时这些参数有一定的顺序要求,详见附录D
  4. 请求的baseURL为有道云笔记的domain,对于线上环境该baseURL为note.youdao.com,而测试环境为notesandbox.youdao.com,下同

一个包含OAuth参数的Header示例如下所示:

Authorization: OAuth oauth_token="64e4f0c25029dd6687ea74cd64e9640a",  
oauth_consumer_key="2456f9dd37e162ffe237c8b88739925f",  
oauth_signature_method="HMAC-SHA1", oauth_timestamp="1343381467",  
oauth_nonce="952606576956129", oauth_version="1.0",  
oauth_signature="%2FLQhn0OCf3lCMPSAAMVW35aUka0%3D"
最后更新: -