选择应用类型
企业内部应用开发
学习地图
动态与公告
应用开发平台简介(新版)
应用开发平台简介
开发应用(新版)
开发应用
服务端API
客户端API
事件订阅
参考
常见问题
历史文档
服务端API
客户端API
小程序
H5微应用
H5微应用JSAPI总览
免登流程
JSAPI参考
免登
设备
日期和月历
通讯录选人
角色
业务
导航栏
弹窗
会话
电话
DING
文件
存储
钉盘
保存文件到钉盘
上传附件到钉盘/从钉盘选择文件
预览钉盘文件
批量预览钉盘图片
选取钉盘目录
图片
地图
音频
摇一摇
UI控件
扫码
支付
授权
转屏横屏
外部联系人
自定义联系人
打开新页面
打开应用
数据加解密
视频会议
办公电话
在线课堂
专属钉钉
钉钉统一授权套件
事件订阅
开发前必读
开发应用
应用管理

上传附件到钉盘/从钉盘选择文件

更新于 2024-01-11调用biz.util.uploadAttachment上传附件到钉盘、从钉盘选择文件。

调试

访问JSAPI Explorer在线调试该接口。

使用说明

调用本接口前,请先引入钉钉js,参考准备工作

该接口支持照片、拍照、本地系统文件和从已有钉盘文件选择,返回值为文件在钉盘系统内的数据信息,如SpaceIDFileID等。其中照片、拍照和本地系统文件将先上传到参数SpaceID指定的钉盘空间再返回,上传过程对开发者透明。

说明

使用场景说明:

  1. 存储空间:调用该jsapi前需要先创建存储空间并授予当前用户对该空间的上传操作权限,请参考添加空间添加权限

  2. 自定义空间:调用该jsapi前需先获取企业自定义空间并授予当前用户对该空间的上传操作权限,请参考获取企业下的自定义空间添加自定义空间权限

客户端

是否需要鉴权

Android

iOS

PC

支持说明

需要

支持

支持

支持

Loading...

参数说明

参数

类型

说明

types

Array[String]

支持上传附件的文件类型,至少一个。

  • photo: 相册

  • camera: 摄像头

  • file: android是“本地文件”, iOS表示从“文件”上传

  • space: 钉盘

说明
  • Android&iOS端:最多支持四种类型["photo","camera","file","space"]

  • PC端:最多支持["photo","file","space"]

image

JsonObject

types这个数组里有photo、camera参数需要构建这个数据。

compress

Boolean

是否压缩,默认为true

multiple

Boolean

是否多选,默认为false

max

Int

最多选择的图片数目,最多支持9张。

isCopy

Int

  • Android&iOS端

    • 1:表示复制到钉盘

    • 0:表示返回选中的文件信息

  • PC端:不支持此参数

spaceId

String

企业自定义空间或存储空间。

folderId

String

文件夹ID。

说明
  • 自定义空间和存储空间可调用添加文件夹接口,实现在空间内添加文件夹。

  • 该参数只支持Android和IOS端。

space

JsonObject

types这个数组里有space参数需要构建这个数据。

file

JsonObject

types这个数组里有file参数需要构建这个数据。

返回结果

参数

类型

说明

type

String

支持上传附件的类型,目前有photo、camera、file、space。

data

Array[Object]

文件上传成功后的数据信息。

spaceId

String

目标空间id。

fileId

String

文件id。

fileName

String

文件名称。

fileType

String

文件类型。

fileSize

Long

文件大小。

这篇文档是否有帮助?
点击纠错