链接复制成功!
修改分享设置 - updateShare
功能介绍
修改分享设置。
授权信息
当前API调用无需身份策略权限。
URI
PUT /koodrive/ose/v1/share/{shareId}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| shareId | 是 | String | 参数解释: 分享ID,创建分享、列表接口返回 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 参数解释: 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| X-Traceid | 否 | String | 参数解释: 业务跟踪id(必须58位) 约束限制: 不涉及 取值范围: 长度为58位 默认值: 不涉及 |
| X-User-Id | 是 | String | 参数解释: KooDrive侧用户id,用于app鉴权 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| X-Date | 是 | String | 参数解释: 日期,用于app鉴权,格式为yyyyMMdd‘T’HHmmss‘Z’ 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: 不涉及 默认值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| extractCode | 否 | String | 参数解释: 设置提取码 约束限制: 长度8个字符 取值范围: [0-9a-zA-Z] 默认值: 不涉及 |
| comment | 否 | String | 参数解释: 分享留言 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| validDays | 是 | Integer | 参数解释: 设置分享有效天数,0表示不设置 约束限制: 不涉及 取值范围: [0,365] 默认值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 响应码 |
| msg | String | 响应信息 |
| shareLink | shareLink object | 分享链接信息 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| shareId | String | 分享id |
| shortUrl | String | 分享链接 |
| extractCode | String | 提取码 |
| createTime | String | 创建时间 |
| updateTime | String | 修改时间 |
| expireTime | String | 失效时间 |
| linkUrl | String | 分享链接 |
| shareTime | String | 分享时间 |
| scope | Integer | 范围 |
| displayName | String | 显示名称 |
| status | Integer | 状态 |
| viewCnt | String | 浏览次数 |
| downloadCnt | String | 下载次数 |
| saveCnt | String | 保存次数 |
请求示例
PUT /koodrive/ose/v1/share/{shareId}
{
"expireTime" : "2025-05-29T02:00:39.952Z",
"extractCode" : "MDg2K0vU",
"comment" : "123",
"validDays" : 9
} 响应示例
状态码:200
OK
{
"shareLink" : {
"shareId" : "1689743054514187776",
"shortUrl" : "1689743054514187777",
"linkUrl" : "1689743054514187777",
"shareTime" : "2025-05-20T01:37:49.052Z",
"expireTime" : "2025-05-29T02:17:41.222Z",
"scope" : 1,
"extractCode" : "MDg2K0vU",
"displayName" : "jpeg格式_20250513_103635.jpeg",
"status" : 0,
"comment" : "123",
"ownerId" : "1681759180324844417",
"containerId" : "IAAB5thdWzxEoAsiA1681759183084696448",
"viewCnt" : 0,
"downloadCnt" : 0,
"saveCnt" : 0,
"updateTime" : "2025-05-20T02:17:41.222Z"
},
"code" : 0,
"msg" : "成功"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |