POST管理接口
创建分片上传会话
上传分三步：创建会话 → 逐个 `PUT` 分片 → `complete` 合并。会话保留 24 小时， 中断后可用 `GET` 查询已接收的分片继续上传。文件名会被收敛为安全文件名 （路径分隔符与保留字符替换为 `_`），超过 `VERHUB_UPLOAD_MAX_MB` 返回 413。 API Key 需要 `files:write` 作用域。
URL
/api/v1/admin/projects/{projectKey}/files/uploads鉴权方式
需要管理员 JWT（Authorization: Bearer <token>）
请求参数
Path 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectKey | string | 是 | 项目主键 project_key（大小写不敏感） |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
请求体
{
"filename": "Verhub-Setup-1.2.0.msi",
"size": 52428800
}响应示例
201 响应
{
"upload_id": "4f3c2b1a0e9d8c7b6a5f4e3d2c1b0a99",
"filename": "Verhub-Setup-1.2.0.msi",
"size": 52428800,
"chunk_size": 8388608,
"total_chunks": 7,
"received_chunks": [
0,
1,
2
],
"storage_backend_id": "local",
"expires_at": 1760086400
}POST