上传 API
资源上传是创建项目的前置步骤。上传模块提供以下接口:
接口列表
| 接口 | 方法 | 说明 |
|---|---|---|
| 获取上传 Token | POST | 获取上传认证凭证 |
| 单文件上传 | POST | 直接上传单个文件 |
| 分片上传 | POST | 大文件分片上传 |
| 查询状态 | GET | 查询上传任务状态 |
认证方式
上传接口使用独立的 Token 认证:
Header: 'ous-token-v2: {ousToken}'注意
ousToken 需要先调用 获取上传 Token 接口获取,globalDomain 也从该接口返回。
上传流程
mermaid
flowchart TD
A[获取上传 Token] --> B{文件大小}
B -->|小于阈值| C[单文件上传]
B -->|大于阈值| D[分片初始化]
D --> E[分片上传]
E --> F[查询状态]
C --> F
F --> G{状态=5?}
G -->|否| F
G -->|是| H[获得资源 URL]状态码
| Status | 含义 | 终态 |
|---|---|---|
| 0 | 草稿 | 否 |
| 1 | 基础检测完成 | 否 |
| 2 | 内容检测完成 | 否 |
| 3 | 排队上传 | 否 |
| 4 | 上传中 | 否 |
| 5 | 上传成功 | ✅ |
| 6 | 上传失败 | ✅ |
| 7 | 审核中 | 否 |
| 8 | 手动中止 | ✅ |
错误码
| Code | 说明 |
|---|---|
| 1 | 配置错误 |
| 2 | 文件大小异常 |
| 3 | 文件格式异常 |
| 4 | 文件内容异常 |
| 5 | 内容安全检测异常 |
| 6 | 上传限制(并发过高) |
| 12 | Token 异常 |
| 13 | 任务不存在或已结束 |