文档首页/ 云空间服务 KooDrive/ API参考/ API/ AI_saas服务调用接口/ 根据视频类型搜索一批视频 - IlistVideoKind
更新时间：2025-10-22 GMT+08:00
查看PDF
分享

根据视频类型搜索一批视频 - 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鉴权

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."
}

状态码

状态码

描述

200

根据视频类型搜索一批视频响应体

401

鉴权失效

相关文档