常见问题

团子全局限速

团子不限制上传、下载速度，也不限制同时正在处理的文件数量。

但团子对每个接口的请求频率有限制，一般无特殊说明情况下，每个接口/每用户的请求频率限制（QPS）为每秒钟5次。超过限制后，您的请求会被取消并返回-1错误码以及QPS过高的错误信息。

多次触发QPS限制可能会暂停API的调用能力，请勿高频调用接口，以免被自动限制。

上传文件接口v1迁移至v2

v1接口停止服务通知

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

切换至v2版本

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

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

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

v1返回

参数名类型必须默认描述
channelstring是上传的通道号。
urlstring是上传歌曲的目标地址。
keystring是持有此字段用以上传歌曲。
OSSAccessKeyIdstring是持有此字段用以上传歌曲。
policystring是持有此字段用以上传歌曲。
signstring是持有此字段用以上传歌曲。

v2返回

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

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

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

v1提交表单请求参数

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

v2提交表单请求参数

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