计算建议分片大小

1. 接口定位

• 接口名称: 计算建议分片大小
• 所属域: object
• 业务目标: 根据文件总大小计算服务端建议的分片大小，便于客户端按后端规则切片

2. 请求定义

• Method: POST
• Path: /object/part_size
• Content-Type: 推荐 application/json
• operationID: 必填，请通过 Header operationID 传入
• 鉴权: 必填，需要通过 Header token 传入有效令牌
• 幂等性: 幂等（只读操作）

3. 请求参数

Header 参数

字段	必填	类型	说明
operationID	是	string	链路追踪 ID
token	是	string	登录令牌

Body 参数

字段	必填	类型	说明
size	是	int64	文件总大小（字节）

字段约束

• size 需大于 0。

4. 响应结构

通用响应包裹

字段	类型	说明
errCode	int	错误码，0 表示成功
errMsg	string	错误简述
errDlt	string	错误详情
data	any	业务数据

data 字段结构

字段	类型	说明
size	int64	服务端建议分片大小（字节）

5. 业务规则

• 调用方持有合法 token 即可调用，无角色限制。
• 建议调用顺序：先 part_limit 了解边界，再 part_size 获取某个文件的建议分片值。

6. 错误码与失败场景

错误码	场景	典型报错
1001	参数不合法（如 size <= 0）	ArgsError
500	服务内部错误	ServerInternalError

7. 示例

fetch 请求示例

fetch("http://localhost:10002/object/part_size", {
  method: "POST",
  headers: {
    operationID: "13c0d47b-8388-4a1d-b808-214a1ee9df22",
    token: "<your-token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    size: 52428800,
  }),
})
  .then((res) => res.json())
  .then((data) => console.log(data));

请求示例（JSON）

{
  "size": 52428800
}

成功响应示例

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "size": 5242880
  }
}

8. 时序流程

1. 客户端提交文件总大小 size。
2. 服务端根据对象存储规则计算建议分片大小。
3. 客户端按返回值切分文件并发起分片上传。

9. 变更记录

• 2026-06-20: 首版补充文档发布。