Skip to content

删除文件

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)

请求参数

NameTypeRequiredInDescription
fileBizIdstringYesbody要删除的文件业务 ID

成功响应

无内容204
"{null}"

错误响应

Unauthorized401
{
  "success": false,
  "code": "4010",
  "message": "Invalid or expired token"
}
Not Found404
{
  "success": false,
  "code": "4040",
  "message": "File not found"
}

说明

  • 本操作为软删除;文件记录被标记为已删除,但不会立即物理移除。
  • 只有原始上传者或授权操作者可以删除文件。

内部文档