mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
42 lines
1.9 KiB
Markdown
42 lines
1.9 KiB
Markdown
# 上传流程
|
|
|
|
### 基本信息
|
|
|
|
| 属性 | 内容 |
|
|
|:---------|:------------------------------|
|
|
| 文档名称 | 上传流程 |
|
|
| 文档版本 | 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 | 创建文档 |
|