获取文件元数据

  • 接口：common/files/batch/getFileMetadata
  • Method：POST
  • 数据格式：JSON
  • 限流信息：每小时1000次
  • 接口说明：本接口为批量接口，接口返回成功不代表全部处理成功。具体参见示例
  • 变更历史

参数

请求参数

字段名称 字段类型 字段描述 是否必填 备注
bizId String 业务唯一识别码 true 长度不超过36
timestamp Long 时间戳 true
data Array 文件名数组 TRUE 数组长度不超过100
data.attachment_url String 附件地址 TRUE 必须包含文件后缀名

返回参数

字段名称 字段类型 字段描述
bizId String 业务唯一识别码
resCode Integer 响应状态码（见附录）
resMsg String 返回信息描述
data Array 处理成功的结果数组
data[].attachment_url String 附件地址
data[].download_url String 文件下载地址，有效期2小时
data[].content_length String 文件大小
data[].content_type String 文件类型
data[].expiration_time String 过期时间
data[].content_encoding String 文件内容编码
data[].content_disposition String 文件内容处理

示例

请求数据

{
  "bizId": "2c1ece50-3cab-4f1c-a5d9-fd297afdd1e2",
  "timestamp": 1733711467549,
  "data": [
    {
      "attachment_url": "94ae2f34-8fec-4843-b058-f7fcdd54f619.png"
    },
    {
      "attachment_url": "61ae2f34-8fcc-4843-b058-f7d54f619.png"
    }
  ]
}

返回数据

全部处理成功返回

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "2c1ece50-3cab-4f1c-a5d9-fd297afdd1e2",
  "data": [
    {
      "attachment_url": "94ae2f34-8fec-4843-b058-f7fcdd54f619.png",
      "content_length": 220600,
      "content_type": "application/octet-stream",
      "download_url": "https://xxx/94ae2f34-8fec-4843-b058-f7fcdd54f619.png?xxx"
    },
    {
      "attachment_url": "61ae2f34-8fcc-4843-b058-f7d54f619.png",
      "content_length": 320610,
      "content_type": "application/octet-stream",
      "download_url": "https://xxx/61ae2f34-8fcc-4843-b058-f7d54f619.png?xxx"
    }
  ]
}

部分处理成功返回

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "2c1ece50-3cab-4f1c-a5d9-fd297afdd1e2",
  "data": [
    {
      "attachment_url": "94ae2f34-8fec-4843-b058-f7fcdd54f619.png",
      "content_length": 220600,
      "content_type": "application/octet-stream",
      "download_url": "https://xxx/94ae2f34-8fec-4843-b058-f7fcdd54f619.png?xxx"
    }
  ]
}

全部处理失败返回

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "2c1ece50-3cab-4f1c-a5d9-fd297afdd1e2",
  "data": []
}

变更历史

变更日期 变更人 变更描述
2025-04-28 李鹏飞 新建密钥信息

历史版本

历史接口 下线日期 描述
获取文件元数据 2025-01-01 定义偏差，定义了驼峰字段

results matching ""

    No results matching ""