API 参考 › 文件上传
POST/uploads/{upload_id}/complete
完成上传(校验并登记资产)
提交各分片的 ETag 完成上传。平台回读对象存储校验实际大小与 SHA-256,
需要 Bearer 令牌
参数
| 名称 | 位置 | 必填 | 说明 |
|---|---|---|---|
upload_id | path | 必填 |
请求体
| 字段 | 必填 | 类型 | 约束 | 说明 |
|---|---|---|---|---|
parts | 必填 | object[] |
curl -X post https://api.cleerscience.com/v1/uploads/<upload_id>/complete \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"parts": [{"part_number": 1, "etag": "\"5b4c8f3a...\""}]}'{
"asset_ref": {
"asset_id": "ast_c4m8x2",
"version": 1
},
"status": "ready"
}状态码
| HTTP | 说明 |
|---|---|
| 200 | 上传完成,返回资产引用 |
| 409 | 上传会话已过期或不活跃 |
| 422 | 分片列表缺失或校验失败 |