dingtalk.oapi.cspace.add (新增文件到用户钉盘)

新增文件到用户钉盘

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
agent_id String 可选 123 微应用的agentId
code String 可选 asdfwd 如果是微应用,code值为微应用免登授权码,如果是服务窗应用,code值为服务窗免登授权码。code为临时授权码,只能消费一次,下次请求需要重新获取新的code。
media_id String 可选 @123 调用钉盘上传文件接口得到的mediaid, 需要utf-8 urlEncode
folder_id String 可选 123 调用云盘选择控件后获取的用户钉盘空间ID
space_id String 可选 234 调用云盘选择控件后获取的用户钉盘文件夹ID
name String 可选 test 上传文件的名称,不能包含非法字符,需要utf-8 urlEncode
overwrite Boolean 可选 true 遇到同名文件是否覆盖,若不覆盖,则会自动重命名本次新增的文件,默认为false

响应参数

名称 类型 示例值 描述
dentry String dentry
errmsg String ok errmsg
errcode Number 0 errcode

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/cspace/add");
OapiCspaceAddRequest req = new OapiCspaceAddRequest();
req.setAgentId("123");
req.setCode("asdfwd");
req.setMediaId("@123");
req.setFolderId("123");
req.setSpaceId("234");
req.setName("test");
req.setOverwrite(true);
req.setHttpMethod("GET");
OapiCspaceAddResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "dentry":"",
    "errmsg":"ok",
    "errcode":0
}

异常示例

  • JSON示例
{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部