# 其他说明

# 上传文件接口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否则服务器无法识别。该字段必须在表单最后的位置。
最后更新时间: 8/27/2024, 4:30:40 AM