上传附件

本文提供调用「上传附件」接口的操作示例。

示例：上传一个附件，并绑定到维格表

假设你有一张图片，你想上传该图片到一张维格表。

你的操作步骤如下：

1. 获取你的 API Token。（获取方法）

2. 获取你的维格表 ID。（获取方法）

3. 获取你的本地图片的绝对路径。

4. 打开你电脑上的终端，执行下列代码，向服务器发送查询请求（假设 datasheetId 为 dstWUHwzTHd2YQaXEE，本地图片的路径为 /Users/coco/Documents/3.jpg）：

   cURL

   curl -X POST \
   https://vika.cn/fusion/v1/datasheets/dstWUHwzTHd2YQaXEE/attachments \
   -H 'Authorization: Bearer {你的 API Token}' \
   -H 'content-type: multipart/form-data' \
   -F 'file=@/Users/coco/Documents/3.jpg'

   Javascript SDK

   注意：需要先下载和初始化 Javascript SDK，再执行如下命令。

   const datasheet = vika.datasheet("dstWUHwzTHd2YQaXEE");
   // node 环境中
   const file = fs.createReadStream('/Users/coco/Documents/3.jpg')
   
   try {
     const resp = await datasheet.upload(file)
     if (resp.success) {
       const uploaded_attachments = resp.data
       await vika.datasheet('dstWUHwzTHd2YQaXEE').records.create([{
         'title': '标题 A',
         'photos': [uploaded_attachments]
         }])
     }
   } catch (error) {
     console.error(error)
   }

   Python SDK

   注意：需要先下载和初始化 Python SDK，再执行如下命令。

   dst = vika.datasheet("dstWUHwzTHd2YQaXEE")
   
   # 上传一个文件到指定维格表
   file = dst.upload_file("/Users/coco/Documents/3.jpg")
   
   # 更新指定记录的「附件」列
   record = dst.records.get(昵称="安安")
   record.附件 = [file]

5. 服务器会返回下列 JSON 数据包，"data" 下即为上传成功的附件信息：

   有关返回结果中各参数的含义，可查看 API 手册。

   {
       "code": 200,
       "success": true,
       "data": {
           "token": "space/2021/06/30/d336232203054effb819231a3426d40d",
           "mimeType": "image/jpeg",
           "size": 229426,
           "height": 1024,
           "width": 1792,
           "name": "3.jpg",
           "url": "https://s4.vika.cn/space/2021/06/30/d336232203054effb819231a3426d40d"
       },
       "message": "SUCCESS"
   }