上传附件

​

路径

POST /api/table/{tableId}/record/{recordId}/{fieldId}/uploadAttachment

​

请求

​

路径参数

• tableId (string): 表的唯一标识符（如何获取）。
• recordId (string): 要更新的记录的唯一标识符 (如何获取）。
• fieldId (string): 要上传到的附件字段 ID (如何获取)

附件字段可以上传多个附件，该 API 每次允许上传一个附件到单元格最末尾

如需删除或调整附件顺序请使用更新记录 API

fieldId 必须为附件类型字段

通过 API 上传的附件在云端版本中最大为 100m, 在私有化版本中无限制

​

请求体

类型：formData

参数：

• file（ 可选）
  • 描述：要更新的记录数据
  • 类型：Buffer 或 ReadStream
• fileUrl（可选）
  • 描述：要进行上传的 URL
  • 类型：字符串
  • 示例：https://app.teable.io/favicon.ico
  • 说明：file 和 fileUrl 同时只能指定一个，若都制定则优先 file

​

响应

​

成功响应

• 状态码: 201 Created
• 响应体: 返回更新后的记录数据。

示例响应体

{
    "id": "rec123456789ABCDE",
    "fields": {
      "fld123456789ABCDE": [
        {
          "id": "act75TiSyhcS7hfrizW",
          "name": "example.jpg",
          "path": "table/example",
          "size": 392903,
          "token": "tokenxxxxx",
          "width": 976,
          "height": 1000,
          "mimetype": "image/jpeg",
          "presignedUrl": "https://sss.teable.io/pvt-assets/table/previewURL"
        }
      ],
    }
}

​

错误响应

• 状态码: 400 Bad Request: 请求体格式错误或缺少必需字段。
• 状态码: 404 Not Found: 指定的表 tableId 或记录 recordId 不存在。

​

示例代码

# 通过文件上传

curl -X POST 'https://app.teable.cn/api/table/__tableId__/record/__recordId__/__fieldId__/uploadAttachment' \
  -H 'Authorization: Bearer __token__' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@/path/to/your/file.jpg'

# 通过 URL 上传
curl -X POST 'https://app.teable.cn/api/table/__tableId__/record/__recordId__/__fieldId__/uploadAttachment' \
  -H 'Authorization: Bearer __token__' \
  -H 'Content-Type: multipart/form-data' \
  -F 'fileUrl=https://example.com/image.jpg'