伙伴云OpenAPI
  1. 文件
伙伴云OpenAPI
  • 开发指南
    • 开发前必读
    • 申请 API Key
    • 基本概念介绍
    • 数据筛选器
    • 更新日志
  • 工作区
    • 获取工作区列表
      GET
    • 获取工作区成员列表
      POST
  • 表格数据
    • 获取表格列表
      POST
    • 获取表格配置
      POST
    • 查询数据列表
      POST
    • 获取数据详情
      POST
    • 创建数据
      POST
    • 更新数据
      PUT
    • 删除数据
      DELETE
    • 批量创建数据
      POST
    • 批量更新或创建数据
      PUT
    • 批量删除数据
      DELETE
  • 数据仓库数据
    • 获取数据仓库表格列表
      POST
    • 获取数据仓库表格配置
      POST
    • 查询数据列表
      POST
    • 获取数据详情
      POST
    • 批量创建数据
      POST
    • 批量更新数据
      PUT
    • 根据数据ID列表更新成相同数据
      PUT
    • 批量删除数据
      DELETE
  • 流程
    • 获取流程列表
    • 查询流程实例列表
    • 获取流程实例详情
    • 获取流程实例的执行记录
    • 查询流程任务列表
    • 获取流程任务详情
  • 文件
    • 批量获取文件详情
      POST
    • 上传文件
      POST
  • 订阅
    • 订阅事件概述
    • Encrypt Key 加解密
    • 订阅回调事件
    • 添加订阅
    • 取消订阅
    • 获取订阅列表
  • 服务商
    • 获取 access_token
    • 获取服务商的 api_key
    • 获取服务商信息
    • 设置订阅回调地址
    • 获取订阅回调地址
  1. 文件

批量获取文件详情

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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错误
上一页
获取流程任务详情
下一页
上传文件
Built with