上传资源

注意：

• 上传文件的名称中，不支持\0字符。
• 若文件名中存在\0字符，则会返回 400 Bad Request 和 error message “key must not contain null byte”。
• 上传文件名 utf-8 编码字符，长度不超过 750 字节 。
• 若有特殊需求，请联系技术支持。
  
  

表单上传

表单上传是指在一个单一的 HTTP POST 请求中完成一个文件的上传，比较适合简单的应用场景和尺寸较小的文件。

表单上传的使用细节请参考表单上传。

分片上传

分片上传是将一个文件分为多个小数据块，每个小数据块以一个独立的 HTTP 请求分别上传。所有小数据块都上传完成后，再发送一个请求给服务端将这些小数据块组织成一个逻辑资源，以完成上传过程。

相比表单上传，分片上传的优势：

• 适合尺寸较大的文件传输，通过分片来避免单个 HTTP 数据量过大而导致连接超时的现象。
• 在网络条件较差的环境下，较小尺寸的文件可以有较高的上传成功率，从而避免无休止的失败重试。
• 支持断点续传。

然而，相比表单上传，分片上传需要多次 HTTP 请求才能完成上传过程，会有额外的成本开销。另外也增加了代码的复杂度，因此选择是否使用分片上传时应谨慎评估使用的必要性。

分片上传的使用细节请参考分片上传 v1 版、分片上传 v2 版，两种分片上传不同见详情。

上传后续动作

在上传时开发者可以指定上传完成后服务端的后续动作，例如回调通知(callback)、自定义响应内容、303重定向等。可设置的后续动作与表单上传中完全一致。

这里需要明确的是，虽然后续动作在生成上传凭证时已经指定，但这些后续动作只在服务端处理完创建文件(mkfile)请求后才会发生，而且也只有mkfile请求的内容可以包含变量。

在线示例

在线断点继上传示例