名称 |
类型 |
必填 |
描述 |
path |
字符串 |
是 |
想要写入到的文件的完整路径。此参数不应指向文件夹。 |
upload_id |
字符串 |
yes |
用于识别要落实的分块上载会话。 |
overwrite |
布尔值 |
否 |
该值(true(缺省值)或 false)确定此上载是否将覆盖现有文件。如果为 true,那么将覆盖任何现有文件。如果为 false,那么其他参数确定是否发生冲突以及如何解决冲突。 |
autorename |
布尔值 |
否 |
该值(true(缺省值)或 false)确定在发生冲突时发生的事项。如果为 true,那么正在上载的文件将自动重命名以避免冲突。(例如,test.txt 可能会自动重命名为 test (1).txt。)可以从返回的元数据获取新名称。如果为 false,那么调用将失败,并且返回 409(冲突)响应代码。 |
locale |
字符串 |
否 |
成功上载返回的元数据将根据指定的语言环境转换其大小字段。 |
parent_rev |
布尔 |
否 |
如果存在,那么此参数指定正在编辑的文件的修订版。如果 parent_rev 匹配用户的 Dropbox 上最新版本的文件,那么将替换此文件。否则,将发生冲突。如果指定 parent_rev 并且此修订版不存在,那么不会保存文件(错误 400)。 |