上传附件或图片

POST

/yws/open/resource/upload.json

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

l **返回结果：**操作成功时http状态为200，对于图片，返回该图片的链接URL，对于普通附件，服务器会为该附件生成一个图标文件，因此返回结果包括该附件对应的链接URL以及图标的URL；失败时http状态为500并返回错误码和错误信息，详见附录B。

需要注意的是，在附件上传完成后，使用者应该紧接着更新对应的笔记，否则不被任何笔记引用的附件将被定期的空间回收所删除。

请求参数

Query 参数

Header 参数

Body 参数multipart/form-data

返回响应

🟢200成功

application/json

Body

🔴500操作失败

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http:///yws/open/resource/upload.json?oauth_token=' \
--header 'oauth_callback: ' \
--header 'oauth_consumer_key: ' \
--header 'oauth_signature_method: ' \
--header 'oauth_verifier: ' \
--header 'oauth_timestamp: {% mock '\''timestamp'\'' , '\''ms'\'' %}' \
--header 'oauth_nonce: ' \
--header 'oauth_version: 1.0' \
--header 'oauth_signature: '

响应示例

200 - 图片附件

{
    "url": "http://baseURL/yws/open/resource/28/d83f547f3055"
}

修改于 2022-08-04 08:06:11

分享笔记链接

下载附件/图片/图标