上传文件 (Upload)

Method: POST

Endpoint:

/api/v1/files

请求参数

• Content-Type: multipart/form-data
• 表单中必须且只能包含一个文件
• 文件大小必须严格小于 10 MiB
• 服务端计算文件内容的 SHA-256 作为 hash

响应示例

首次上传返回 201，同一用户重复上传同一内容返回 200：

{
  "data": {
    "filesId": 1,
    "hash": "完整 sha256",
    "uTime": 1762300000,
    "owner": 1
  }
}

错误

• 400 / INVALID_FORM_DATA：不是合法的 multipart 表单
• 400 / INVALID_FILE_COUNT：文件数量不是 1
• 413 / FILE_TOO_LARGE：文件大小达到或超过 10 MiB