# 其他说明
# 上传文件接口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 否则服务器无法识别。该字段必须在表单最后的位置。 |
← 任意乐器分离