Skip to content

上传 API

资源上传是创建项目的前置步骤。上传模块提供以下接口:

接口列表

接口方法说明
获取上传 TokenPOST获取上传认证凭证
单文件上传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上传限制(并发过高)
12Token 异常
13任务不存在或已结束