根据视频类型搜索一批视频 - IlistVideoKind

功能介绍

根据视频类型搜索一批视频

授权信息

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

URI

GET /koodrive/ose/v1/listVideoKind

表1 Query参数
参数	是否必选	参数类型	描述
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	查询获得的文件信息

表4 File
参数	参数类型	描述
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	用户权限

表5 properties
参数	参数类型	描述
additionalProp1	String	文件公共自定义属性1
additionalProp2	String	文件公共自定义属性2
additionalProp3	String	文件公共自定义属性3

表6 appSettings
参数	参数类型	描述
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."
}