删除文件
POST
/web/v1/files/command/deleteJWT + Turnstile软删除一条文件记录。文件元数据将被标记为已删除,但物理存储对象可能会在可配置的期限内保留。
鉴权
Auth Chain: WEB Chain — 需要
Authorization: Bearer <jwt>和 Turnstile token。 以下 header 由系统注入(前端无需处理):X-PORTAL-ACCESS-CODE(Nginx),X-Request-Id(Gateway)
请求参数
| Name | Type | Required | In | Description |
|---|---|---|---|---|
fileBizId | string | Yes | body | 要删除的文件业务 ID |
成功响应
无内容204
"{null}"错误响应
Unauthorized401
{
"success": false,
"code": "4010",
"message": "Invalid or expired token"
}Not Found404
{
"success": false,
"code": "4040",
"message": "File not found"
}说明
- 本操作为软删除;文件记录被标记为已删除,但不会立即物理移除。
- 只有原始上传者或授权操作者可以删除文件。