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

批量收藏文件接口 - batchStarFile

功能介绍

批量收藏或取消收藏文件接口,最大支持100个。

授权信息

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

URI

POST /koodrive/ose/v1/star/batch

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

参数解释:

该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token}

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

X-Traceid

String

参数解释:

业务跟踪id(必须58位)

约束限制:

不涉及

取值范围:

长度为58位

默认值:

不涉及

language

String

参数解释:

国际化语言标识

约束限制:

符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语

取值范围:

符合i18n规范

默认取值:

en-US

X-User-Id

String

参数解释:

KooDrive侧用户id,用于app鉴权

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

X-Date

String

参数解释:

日期,用于app鉴权,格式为yyyyMMdd‘T’HHmmss‘Z’

约束限制:

距当前时间15分钟以内,不能晚于当前时间

取值范围:

不涉及

默认值:

不涉及

表2 请求Body参数

参数

是否必选

参数类型

描述

starred

Boolean

参数解释:

是否收藏

约束限制:

不涉及

取值范围:

true,false

默认取值:

不涉及

subRequestList

Array of StarFileRequest objects

批量收藏文件列表

参数解释:文件列表

约束限制:列表长度<=100

取值范围:不涉及

默认取值:不涉及

表3 StarFileRequest

参数

是否必选

参数类型

描述

containerId

String

空间id

参数解释:空间id

约束限制:不涉及

取值范围:不涉及

默认取值:不涉及

fileId

String

文件id,不允许重复

参数解释:文件id

约束限制:不涉及

取值范围:不涉及

默认取值:不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

status

Integer

响应状态,0:全部成功,1:部分成功,2:全部失败

subResponseList

Array of SubResponse objects

子响应列表

code

String

响应码

msg

String

响应信息

表5 SubResponse

参数

参数类型

描述

fileId

String

文件id

code

String

响应码

message

String

响应信息

请求示例

{
  "starred" : true,
  "subRequestList" : [ {
    "containerId" : "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4",
    "fileId" : "Fn1bTLIOomJkTCAe9DEVBRY4U6IkuqkMZ"
  } ]
}

响应示例

状态码:200

OK

{
  "status" : 0,
  "subResponseList" : [ {
    "fileId" : "Fn1bTLIOomJkTCAe9DEVBRY4U6IkuqkMZ",
    "code" : "0",
    "message" : "success"
  } ]
}

状态码

状态码

描述

200

OK