常见问题

上传文件接口v1迁移至v2

v1接口停止服务通知

团子现已全站完成v1版本的上传接口升级，v1版本将于2025年6月1日后停止服务，请尽快升级您的代码。

切换至v2版本

在创建上传通道时，您需要在请求中携带uploadVersion字段，值为2，以此来指定使用v2版本的上传接口。

创建上传通道时返回信息的变化

v1和v2在创建上传通道时，返回的结果有所不同，v2将上传歌曲所需表单字段全部整合到form字段中，您无需关心form字段内容如何，现在它可能会和URL一起动态变化，您仅需在上传时提交给指定URL即可。

v1返回

参数名	类型	必须	默认	描述
channel	string	是		上传的通道号。
url	string	是		上传歌曲的目标地址。
key	string	是		持有此字段用以上传歌曲。
OSSAccessKeyId	string	是		持有此字段用以上传歌曲。
policy	string	是		持有此字段用以上传歌曲。
sign	string	是		持有此字段用以上传歌曲。

v2返回

参数名	类型	必须	默认	描述
channel	string	是		上传的通道号。
url	string	是		上传歌曲的目标地址。
form	object	是		上传表单，持有此字段用以上传歌曲。

上传文件提交表单时的变化

在v2版本中，您需要将form字段动态的作为表单的键值对，同时在表单的最后一位添加一个file字段，值为要上传的文件。

v1提交表单请求参数

参数名	类型	必须	默认	描述
x-oss-forbid-overwrite	string	是	true	值必须为true，否则上传必定出错。
key	string	是		值为“创建上传通道接口”返回结果中的"key"值。
OSSAccessKeyId	string	是		值为“创建上传通道接口”返回结果中的"OSSAccessKeyId"值。
policy	string	是		值为“创建上传通道接口”返回结果中的"policy"值。
Signature	string	是		值为“创建上传通道接口”返回结果中的"sign"值，请注意此参数名为“Signature”，而“创建上传通道接口”返回结果的字段名为“sign”。
file	File	是		要上传的文件，字段名必须为file否则服务器无法识别。该字段必须在表单最后的位置。

v2提交表单请求参数

参数名	类型	必须	默认	描述
form的键1	...	...	...	form的值1
form的键2	...	...	...	form的值2
...	...	...	...	...
file	File	是		要上传的文件，字段名必须为file否则服务器无法识别。该字段必须在表单最后的位置。