创建笔记

POST

/yws/open/note/create.json

l **是否需要用户认证：**是 (关于登录授权，参见OAuth1.0a授权说明)

l **返回结果：**操作成功时http状态200，并返回新创建笔记的路径；失败时http状态500并返回错误码和错误信息，详见附录B。

注：

如果第三方应用没有指定notebook，则在该第三方应用对应的默认笔记本中创建该笔记。

对于创建时间，主要作用在于对移动端的应用，笔记的创建时间和同步时间可能差别较大，因此如果不指定该时间，笔记的创建时间则会显示为同步时间而非本身的创建时间。

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http:///yws/open/note/create.json?oauth_token=' \
--header 'oauth_callback;' \
--header 'oauth_consumer_key;' \
--header 'oauth_signature_method;' \
--header 'oauth_verifier;' \
--header 'oauth_timestamp;' \
--header 'oauth_nonce;' \
--header 'oauth_version;' \
--header 'oauth_signature;' \
--form 'content=""'

响应示例

200 - 成功示例

{
  "path": "/4AF64012E9864C/FE89D12134E"
}

请求参数

Query 参数

oauth_token

string

必需

请求request_token时返回的oauth_token

Header 参数

oauth_callback

string

必需

（适用于OAuth 1.0a）回调url，该url可以为oob,代表不回调。另外url还可以跟其他参数

默认值:

oauth_consumer_key

string

必需

（适用于OAuth 1.0a）第三方应用的Consumer Key

默认值:

oauth_signature_method

string

必需

（适用于OAuth 1.0a）签名方法，支持HMAC-SHA1

默认值:

oauth_verifier

string

必需

（适用于OAuth 1.0a）用户授权后得到的oauth_verifier，或者是授权页面显示的授权码

默认值:

oauth_timestamp

string

必需

（适用于OAuth 1.0a）时间戳，当前时间，单位毫秒

默认值:

{% mock 'timestamp' , 'ms' %}

oauth_nonce

string

必需

（适用于OAuth 1.0a）随机串，为了防止重放攻击，5分钟内同一用户同一应用同一时间发来的请求中oauth_nonce应不同

默认值:

oauth_version

string

必需

（适用于OAuth 1.0a）1.0

默认值:

1.0

oauth_signature

string

必需

（适用于OAuth 1.0a）使用consumerSecret + ’&’ + oauth_token_secret(该secret为请求request_token时返回的oauth_token_secret，即Request Token Secret)字串作为key, 而签名的内容是除oauth_signature以外的请求url内容，计算签名完毕后，使用base64编码具体签名方法见附录D

默认值:

Body 参数multipart/form-data

source

string

笔记来源URL

可选

author

string

笔记作者

可选

title

string

笔记标题

可选

content

string

必需

笔记正文（笔记格式见附录A）

create_time

string

可选

创建时间，单位为秒，如果不指定则使用系统时间

notebook

string

可选

该新建笔记所属的笔记本路径

返回响应

🟢200成功

application/json

Body

path

string

必需

🔴500操作失败

删除笔记本

查看笔记