批量获取文件详情

POST

https://api.huoban.com/openapi/v1/files

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

请求参数

Header 参数

Open-Authorization

string

必需

授权的 API Key

默认值:

Bearer {{API_KEY}}

Body 参数application/json

file_ids

array[integer]

文件ID

必需

最多100个

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.huoban.com/openapi/v1/files' \
--header 'Open-Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "file_ids": [
        193807809,
        188807768,
        188807632
    ]
}'

返回响应

🟢200成功

application/json

Body

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"
}

🟢200异常

🔴500500错误

修改于 2024-01-24 09:29:18

删除数据

上传文件