# 上传流程

### 基本信息

| 属性       | 内容                            |
|:---------|:------------------------------|
| 文档名称     | 上传流程                         |
| 文档版本     | 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. 对象存储返回上传成功后，普通上传或断点续传完成。

## 相关接口

- [文件上传](文件上传.md)
- [获取上传凭证](获取上传凭证.md)
- [断点续传](断点续传.md)
- [阿里云 OSS 上传文件说明](https://help.aliyun.com/zh/oss/user-guide/upload-objects-to-oss/)

## 注意事项

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

### 修改历史

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