Skip to content

清理图片元数据 (Clear)

Method: POST

Endpoint:

/api/v1/image/{hash}

路径参数

参数 类型 说明
hash String 原图片的 SHA-256

请求参数

Body (JSON):

功能 key 字符串数组，不能为空：

["date", "location"]

支持的 key：

  • makeModel
  • date
  • cameraParameters
  • location

处理逻辑

  1. 校验登录态和文件归属
  2. 使用 ExifTool 清理指定元数据
  3. 原文件保留，处理结果按新 hash 入库
  4. 返回新 hash，可用 GET /api/v1/files/{新 hash} 下载

响应示例

{
  "data": {
    "originalHash": "原 hash",
    "hash": "处理后 hash",
    "keys": ["date", "location"],
    "file": {
      "filesId": 2,
      "hash": "处理后 hash",
      "uTime": 1793850413,
      "owner": 1
    }
  }
}

错误

  • 400：JSON 非法、key 不支持、数组为空
  • 401：未登录
  • 404：文件不存在或不属于当前用户
  • 422 / IMAGE_PROCESS_FAILED：ExifTool 处理失败