授权用户访问企业的自定义空间旧版SDK
更新于 2024-01-11
浏览器可能会转义某些字符导致请求失败，调试时请使用curl或者代码模拟请求。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限 | API Explorer调试 |
企业内部应用 | 是 | 重要 暂不支持新增申请。 | — |
第三方企业应用 | 是 | 重要 暂不支持新增申请。 | — |
第三方个人应用 | 否 | — | — |
基本信息
请求方式：GET
请求地址：https://oapi.dingtalk.com/cspace/grant_custom_space
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx |
|
agent_id | String | 否 | 123 | 应用的AgentId。 |
domain | String | 是 | aa | 企业内部调用时传入，授权访问该domain的自定义空间。该值来自获取企业下的自定义空间接口参数 |
type | String | 是 | add | 权限类型：
|
userid | String | 是 | user123 | 授权的企业用户userid。 |
path | String | 否 | /test | 授权访问的路径，如授权访问所有文件传“/”。 例如授权访问/doc文件夹传“/doc/” ，需要使用utf-8 urlEncode。 说明 type为add时必须传递。 |
fileids | String | 否 | 123 | 授权访问的文件ID列表，多个文件之间用英文逗号隔开，如“fileId1,fileId2”。 说明 type为download时必须传递。 |
duration | Number | 是 | 30 | 权限有效时间，有效范围为0~3600秒，超出此范围或不传默认为30秒。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
errmsg | String | ok | 返回码描述。 |
errcode | Number | 0 | 返回码。 |
示例
请求示例（HTTP）
授权上传，传入需要上传的路径。如在根目录下上传一个文件：
Loading...授权下载，传入需要下载的文件id列表。如授权下载xxx和yyy两个文件：
Loading...
请求示例（JAVA SDK）
返回示例
