批量收藏文件接口 - batchStarFile
功能介绍
批量收藏或取消收藏文件接口,最大支持100个。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/star/batch
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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分钟以内,不能晚于当前时间 取值范围: 不涉及 默认值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
starred | 是 | Boolean | 参数解释: 是否收藏 约束限制: 不涉及 取值范围: true,false 默认取值: 不涉及 |
subRequestList | 是 | Array of StarFileRequest objects | 批量收藏文件列表 参数解释:文件列表 约束限制:列表长度<=100 取值范围:不涉及 默认取值:不涉及 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
status | Integer | 响应状态,0:全部成功,1:部分成功,2:全部失败 |
subResponseList | Array of SubResponse objects | 子响应列表 |
code | String | 响应码 |
msg | String | 响应信息 |
请求示例
{
"starred" : true,
"subRequestList" : [ {
"containerId" : "IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4",
"fileId" : "Fn1bTLIOomJkTCAe9DEVBRY4U6IkuqkMZ"
} ]
} 响应示例
状态码:200
OK
{
"status" : 0,
"subResponseList" : [ {
"fileId" : "Fn1bTLIOomJkTCAe9DEVBRY4U6IkuqkMZ",
"code" : "0",
"message" : "success"
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |

