MeBox/115doc/115开放平台/API列表/文件管理/文件上传/上传流程.md

上传流程

基本信息

属性	内容
文档名称	上传流程
文档版本	v1.0
适用场景	115开放平台文件上传

文档说明

本文档说明 115 开放平台的文件秒传、普通上传和断点续传流程。

流程概览

1. 请求「文件上传」接口初始化上传。
2. 若响应中 status=2，表示秒传成功，上传流程结束。
3. 若响应提示需要二次认证，按 sign_check 指定的字节范围计算大写 SHA1，然后携带 sign_key 和 sign_val 重新请求「文件上传」接口。
4. 若 status=1，携带初始化响应中的 bucket、object、callback 及「获取上传凭证」接口返回的凭证，向对象存储上传文件。
5. 需要续传时，携带初始化响应中的 pick_code 及待上传文件信息请求「断点续传」接口，获取新的对象存储上传参数。
6. 对象存储返回上传成功后，普通上传或断点续传完成。

相关接口

• 文件上传
• 获取上传凭证
• 断点续传
• 阿里云 OSS 上传文件说明

注意事项

• 对象存储上传不请求 proapi.115.com，应使用「获取上传凭证」和上传调度接口返回的域名、对象标识、临时凭证与回调参数发起请求。
• sign_check 的起止字节均在 SHA1 计算范围内。例如 0-99 表示计算共 100 字节的内容。
• 调用开放平台接口时必须携带 Authorization: Bearer access_token，并妥善保管临时上传凭证。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档