更新时间:2026-02-03 GMT+08:00

批量取消分享 - batchCancel

功能介绍

批量取消分享。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/share/cancel

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

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分钟以内,不能晚于当前时间

取值范围:

不涉及

默认值:

不涉及

X-Hw-Agentname

String

参数解释:

运营商名称

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

shareIds

Array of strings

参数解释:

需要取消的分享ID列表

约束限制:

包含的分享ID最少一个,最多100个

取值范围:

不涉及

默认值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

code

String

响应码

msg

String

响应信息

subResponseList

Array of ShareSubResponse objects

子响应列表

表4 ShareSubResponse

参数

参数类型

描述

code

Integer

子响应码

msg

String

子响应信息

请求示例

POST /koodrive/ose/v1/share/cancel

{
  "shareIds" : [ "1689759841444195840" ]
}

响应示例

状态码:200

OK

{
  "subResponseList" : [ {
    "shareId" : "1689759841444195840",
    "code" : 0,
    "msg" : "success"
  } ],
  "code" : 0,
  "msg" : "Success."
}

状态码

状态码

描述

200

OK