SourceMap 分片上传关联接口使用说明¶

分片上传流程¶

1. 分片上传事件初始化：指定应用、环境和版本，获取上传任务标识 uploadId。
2. 上传单个分片：将 SourceMap 压缩包切片，按同一 uploadId 和各片的 chunkIndex 上传。单片大小控制在 10MB 以内。
3. 列出已上传分片：读取该任务的 chunkIndexs，在任务有效期内补传缺失分片。
4. 合并各分片生成文件：确认分片全部上传后调用。服务端按分片序号合并压缩包，并提交异步解压任务。

合并接口成功表示文件已合并并提交解压任务，不代表解压已完成或 SourceMap 已可用于解析。

初始化结果与有效期¶

• uploadId 默认有效期为 3600 秒。后续上传、列出分片和合并都应使用同一有效任务 ID。
• 初始化返回 existsSameFile=true 且未设置 needCover=true 时，可能返回空 uploadId。应先确认是否需要覆盖同一应用、环境和版本的文件，再决定是否重新初始化。
• 收到 ft.InvalidUploadId 时，应重新初始化任务并重新上传所需分片；不要继续复用失效 ID。

取消上传¶

通过 取消一个分片上传事件 取消 uploadId 对应的整个有效任务，删除任务缓存和该任务的分片目录。该接口不能用于只删除某一个分片。

任务已失效时，取消接口不保证清理旧分片目录；重新上传需使用新初始化的 uploadId。

单文件内容上传¶

上传单个文件内容 用于直接上传 SourceMap 解压后的单个源文件内容。按接口要求传入应用、环境、版本、文件名和内容即可，无需走分片初始化与合并流程。上述 10MB 限制对应分片上传接口。