伙伴云OpenAPI

批量获取文件详情

POST/openapi/v1/files

用于获取文件详情，单次最多批量获取 100 个文件。
获取到的文件链接有效期 1 小时，请尽快下载，或每次使用时即时获取，避免长时间使用接口返回的链接，以免过期后无法访问。
仅支持获取表格数据中图片字段、附件字段、富文本字段中的文件，暂不支持获取大数据表中的文件。

请求参数

file_ids

array[integer]

文件ID

必需

最多100个

{
  "file_ids": [
    193807809,
    188807768,
    188807632
  ]
}

示例代码

返回响应

成功(200)

异常(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

必需

message

string

必需

data

object

必需

success

array [object {8}]

成功的file对象数组

必需

fail

array[integer]

失败的file_id数组

必需

meta

object

必需

trace_id

string

必需

version

string

必需

{
  "code": 0,
  "message": "success",
  "data": {
    "success": [
      {
        "file_id": 203897308,
        "name": "name.jpg",
        "ref_id": 2300002281451878,
        "ref_type": "item",
        "link": {
          "small": "https://cos.ap-shanghai.myqcloud.com/",
          "medium": "https://cos.ap-shanghai.myqcloud.com/",
          "large": "https://cos.ap-shanghai.myqcloud.com/",
          "square": "https://cos.ap-shanghai.myqcloud.com/",
          "source": "https://cos.ap-shanghai.myqcloud.com/",
          "download": "https://cos.ap-shanghai.myqcloud.com/"
        },
        "size": 224093,
        "ext": "gif",
        "filetype": "image"
      }
    ],
    "fail": [
      203897309,
      203897310
    ]
  },
  "meta": {
    "trace_id": "9377ad42ced5b95d28383a0877facc92"
  },
  "version": "v1.0.1"
}

最后修改时间： 10 个月前