- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- API参考
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功！
创建分享
功能介绍
创建分享。
URI
POST /koodrive/ose/v1/share
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Authorization |
是 |
String |
该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} |
|
X-Traceid |
否 |
String |
业务跟踪id（必须58位） |
|
X-User-Id |
是 |
String |
用户id，用于app鉴权 |
|
X-Date |
是 |
String |
日期，用于app鉴权 |
|
Host |
是 |
String |
地址，用于app鉴权 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
scope |
是 |
Integer |
分享范围，1：外链分享（该功能目前只有白名单用户使用），2：仅企业内用户可访问，3：指定企业用户访问 |
|
deptIds |
否 |
Array of strings |
部门id列表 |
|
groupIds |
否 |
Array of strings |
用户组id列表 |
|
userIds |
否 |
Array of strings |
用户id列表 |
|
fileIds |
是 |
Array of strings |
文件id列表 |
|
containerId |
是 |
String |
空间id |
|
permission |
否 |
SharePermission object |
分享权限（后续支持） |
|
extractCode |
否 |
String |
提取码 |
|
expireTime |
否 |
String |
失效时间 |
|
comment |
否 |
String |
分享留言 |
|
validDays |
是 |
Integer |
有效分享天数（1-365） |
|
expiredType |
否 |
String |
失效类型 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
响应码 |
|
msg |
String |
响应信息 |
|
shareLink |
shareLink object |
分享链接信息 |
请求示例
POST /koodrive/ose/v1/share
Authorization:Bearer+10f88**********4791e9ff
{
"scope": 0,
"deptIds": [
"string"
],
"groupIds": [
"string"
],
"userIds": [
"string"
],
"fileIds": [
"string"
],
"containerId": "string",
"permission": {
"preview": true,
"edit": true,
"download": true
},
"extractCode": "string",
"expireTime": "2024-06-03T01:54:57.288Z",
"comment": "string",
"validDays": 0
}响应示例
状态码：200
OK
{
"shareLink" : {
"shareId" : "1537770199275722240",
"shortUrl" : "1537770199275722241",
"linkUrl" : "https://kdconsole-test-gray.hwcloudtest.cn:8080/cloudfile/#/sharelink/i/1537770199275722241",
"extractCode" : "",
"comment" : "",
"expireTime" : "2024-10-29T09:14:52.948Z"
},
"code" : 0,
"msg" : "success"
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
