保存文件到自定义或审批钉盘空间

说明

调用本接口将文件保存到自定义钉盘空间或审批附件钉盘空间。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请和基础概念。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端接口的授权凭证。企业内部应用可通过调用access_token接口获得。第三方企业应用可通过调用get_corp_token接口获得。

示例值:

6d1bxxxx

agent_id

string

可选

应用的AgentId。企业内部应用可以在开发者后台的应用详情页获取。第三方企业应用可以调用获取企业授权信息接口获取。

示例值:

123

code

string

必需

code值为应用免登授权码：小程序免登H5微应用免登

示例值:

a6981a1df0c03297b70aa23a6db2ce65

media_id

string

必需

调用单步文件上传接口得到的media_id。

示例值:

@123

space_id

string

钉盘空间ID。

必需

示例值:

234

folder_id

string

可选

钉盘文件夹ID。如果space_id是审批附件钉盘，folder_id参数传0。如果space_id是自定义钉盘，该参数不传。

示例值:

name

string

必需

上传文件的名称，不能包含非法字符，需要utf-8 urlEncode。必须带文件扩展名。

示例值:

test.pdf

overwrite

string

可选

遇到同名文件是否覆盖。若不覆盖，则会自动重命名本次新增的文件，默认为false不覆盖。

示例值:

true

Body 参数application/json

object {0}

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

dentry

string

文件的详细信息。

可选

errmsg

string

返回码描述。

可选

errcode

number

返回码详情。

可选

示例

{
  "dentry": "string",
  "errmsg": "string",
  "errcode": 0
}

保存文件到自定义或审批钉盘空间

说明#

权限#

请求参数

示例代码

返回响应

说明

权限