# 根据视频类型搜索一批视频 - IlistVideoKind #### 功能介绍 根据视频类型搜索一批视频 #### 授权信息 当前API调用无需身份策略权限。 #### URI GET /koodrive/ose/v1/listVideoKind 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | kind | 是 | String | 类型，对应具体类型有：全部,电视剧,综艺,电影,动漫,少儿,纪录片,体育,游戏,课程,科技,生活 | | cursor | 否 | String | 游标 | | pageSize | 是 | Integer | 每页数量，范围 \[1,100\] | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Authorization | 是 | String | 鉴权头 | | X-Date | 是 | String | 参数解释：签名时间，用于appId鉴权 约束限制：距当前时间15分钟以内，不能晚于当前时间 取值范围：日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z 默认取值：不涉及 | | X-User-Id | 是 | String | 用户id，不用于appId鉴权 | | language | 否 | String | 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语 | | X-AIUser-Id | 否 | String | 用户id，用于appId鉴权，与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | nextCursor | String | 分页游标，如果不存在，代表已返回最后一个 | | files | Array of [File] objects | 查询获得的文件信息 | 表4File | 参数 | 参数类型 | 描述 | |:---|:---|:---| | category | String | 类型 | | id | String | 文件id | | fileName | String | 文件名，最长160个字节 | | fileType | String | 文件类型，外部输入 | | mimeType | String | 内容类型 | | description | String | 文件描述。字符串长度不超过512，不能包括emoji和非法字符。 | | favorite | Boolean | 文件是否被收藏 | | recycled | Boolean | 文件是否被放入回收站 | | directlyRecycled | Boolean | 文件是否被直接被放入回收站（随着文件夹删除为false，直接删除为true） | | recyclingUser | Object | 放入回收站的用户 | | recycledTime | String | 放入回收站的时间 | | parentFolder | Array of strings | 父目录ID列表，注意：当前只取第一个父母Id | | properties | [properties] object | 文件公共自定义属性。key-value个数不能超过30个；单个key-value长度不超过124字符 | | appSettings | [appSettings] object | 应用自定义属性。key-value个数不能超过30个；单个key-value长度不超过124字符 | | containers | Array of strings | 空间标识 | | version | Integer | 版本号 | | createdTime | String | 文件创建时间 | | editedTime | String | 文件修改时间 | | editedByMeTime | String | 我修改文件时间 | | editedByMe | Boolean | 是否是我修改文件 | | sharedWithMeTime | String | 共享给我的时间 | | sharer | Object | 分享者 | | owners | Array of objects | 拥有者 | | lastEditor | Object | 最后编辑者 | | hasShared | Boolean | 是否共享 | | ownedByMe | Boolean | 是否是我上传 | | capabilities | Object | 权限 | | viewersHasCopyContentPermission | Boolean | 浏览者是否可以拷贝内容 | | writerHasCopyPermission | Boolean | 拷贝是否需要writer权限 | | writersHasSharePermission | Boolean | writer能否share | | originalFilename | String | 原始文件名，最长80个字符。不能包括'\<\>\|:"\*?/'和emoji，不能等于'..','.','' | | fullFileSuffix | String | 完整的文件后缀，取name第一个.后的字符串 | | fileSuffix | String | 文件后缀，fullFileExtension最后一个字符串 | | size | Integer | 文件大小 | | pictureMetadata | Object | 图片元数据 | | videoMetadata | Object | 视频元数据 | | audioMetadata | Object | 音频元数据 | | sha256 | String | 文件的sha256 | | lastHistoryVersionId | String | 最新的历史记录版本ID | | attachments | Array of objects | 附件(用途, 附件), 只有风控服务appid返回 | | iconDownloadLink | String | 图标链接 | | existThumbnail | Boolean | 是否有缩略图 | | privateKey | String | 特殊文件夹标识，使用规则如下: 命名不得使用_default 仅允许在空间的根目录下创建时指定 仅允许在创建文件夹时指定 同一空间下不得重复 | | localPath | String | 变更时的父目录顶层id路径(取前10层),变更记录和文件查询接口返回 | | sortName | String | 转换fileName后的排序名称 | | userProperties | Object | 用户属性 | | userCapabilities | Object | 用户权限 | 表5properties | 参数 | 参数类型 | 描述 | |:---|:---|:---| | additionalProp1 | String | 文件公共自定义属性1 | | additionalProp2 | String | 文件公共自定义属性2 | | additionalProp3 | String | 文件公共自定义属性3 | 表6appSettings | 参数 | 参数类型 | 描述 | |:---|:---|:---| | additionalProp1 | String | 应用自定义属性1 | | additionalProp2 | String | 应用自定义属性2 | | additionalProp3 | String | 应用自定义属性3 | **状态码：401** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 状态码 | | msg | String | 状态描述 | #### 请求示例 获取视频类型为'体育'的视频，返回前10个 ``` GET /koodrive/ose/v1/listVideoKind?kind=体育&pageSize=10 Authorization:Bearer+10f88*********4791e9ff ``` #### 响应示例 **状态码：200** 根据视频类型搜索一批视频响应体 ``` { "files" : [ { "id" : "Fq0uJAdc3jUCa-z1G_MlEUb2vlcRLtfpA", "fileName" : "trailer.mp4", "favorite" : false, "mimeType" : "video/mp4", "fileSuffix" : "mp4", "recycled" : false, "hidden" : false, "size" : 4372373, "parentFolder" : [ "DFuQcxZyCdwArootIAAGinBbkHMWcgncA1649474998391492994" ], "containers" : [ "IAAGinBbkHMWcgncA1649474998391492994" ], "properties" : { "duration" : "52209", "localCreatedAt" : "", "localUpdatedAt" : "", "auditResult" : "{\"auditDetail\":\"{}\",\"auditLevel\":10,\"auditResult\":4}" }, "sha256" : "b670602fa00934ca27c4351bb0efe7ea7a07fae57284e44226025eeed7c51254", "attachments" : [ { "asset" : { "mimeType" : "video/mp4", "resource" : { "object" : { "id" : "9a4e2278eeb84dd4a3dfba0abb07d7d6086", "start" : 0, "downloadUrl" : { "url" : "xxx", "method" : "GET" } } } }, "hash" : "b670602fa00934ca27c4351bb0efe7ea7a07fae57284e44226025eeed7c51254", "usage" : "content", "sha256" : "b670602fa00934ca27c4351bb0efe7ea7a07fae57284e44226025eeed7c51254" } ], "owners" : [ { "category" : "drive#user", "me" : true, "permissionId" : "1649474998584375040", "userId" : "xxx" } ], "lastEditor" : { "category" : "drive#user", "me" : false, "permissionId" : "1605693059704715008", "userId" : "xxx" }, "fileType" : "20", "createdTime" : "2025-06-13T03:06:07.953Z", "editedTime" : "2025-06-13T03:06:08.919Z", "userProperties" : { "properties" : { "hidden" : "false" } }, "userCapabilities" : { "addChildNodePermission" : true, "copyPermission" : true, "deletePermission" : true, "downloadPermission" : true, "editPermission" : true, "listChildNodePermission" : true, "removeChildNodePermission" : true, "renameFilePermission" : true, "shareFilePermission" : true, "uploadPermission" : true, "viewPermission" : true }, "creatingUser" : "xxx" } ], "code" : 0, "msg" : "Success." } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 根据视频类型搜索一批视频响应体 | | 401 | 鉴权失效 |