上传附件到钉盘/从钉盘选择文件
更新于 2024-01-11调用biz.util.uploadAttachment上传附件到钉盘、从钉盘选择文件。
调试
访问JSAPI Explorer在线调试该接口。
使用说明
调用本接口前,请先引入钉钉js,参考准备工作。
该接口支持照片、拍照、本地系统文件和从已有钉盘文件选择,返回值为文件在钉盘系统内的数据信息,如SpaceID、FileID等。其中照片、拍照和本地系统文件将先上传到参数SpaceID指定的钉盘空间再返回,上传过程对开发者透明。
使用场景说明:
自定义空间:调用该jsapi前需先获取企业自定义空间并授予当前用户对该空间的上传操作权限,请参考获取企业下的自定义空间和添加自定义空间权限。
客户端 | 是否需要鉴权 | Android | iOS | PC |
支持说明 | 需要 | 支持 | 支持 | 支持 |
参数说明
参数 | 类型 | 说明 |
types | Array[String] | 支持上传附件的文件类型,至少一个。
说明
|
image | JsonObject | types这个数组里有photo、camera参数需要构建这个数据。 |
compress | Boolean | 是否压缩,默认为true。 |
multiple | Boolean | 是否多选,默认为false。 |
max | Int | 最多选择的图片数目,最多支持9张。 |
isCopy | Int |
|
spaceId | String | 企业自定义空间或存储空间。 |
folderId | String | 文件夹ID。 说明
|
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 | 文件大小。 |