服务端API



获取素材库分类列表

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/file/category/list
Query参数说明：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
page Int 否 页码，默认从1开始
page_size Int 否 每页条数，最大100，最大100

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "uuid": "E9776691-0BD1-4F6D-9736-58A7A0AA6457",
                "title": "网络推广",
                "parent_id": "1",
                "create_time": 1543475375000
            },
        ],
        "has_more": 1
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
uuid String 素材唯一ID，最大长度36字符
title String 分类标题
parent_id String 父id
create_time Int 创建时间，Unix时间戳，单位毫秒
has_more Int 是否还有数据没返回：
1 还有
0 没有



获取素材库列表

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/file/file/list
Query参数说明：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
page Int 否 页码，默认从1开始
page_size Int 否 每页条数，最大100，最大100

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "uuid": "006078AC-FD16-48CE-872E-1E49EBF9BAD9",
                "object": "dingc4cffb655c00d67f35c2f4657eb6378f/course/video/dcEwKkkzXwe6sRNw1616662221322.mp4",
                "convert_object": "dingc4cffb655c00d67f35c2f4657eb6378f/course/video/dcEwKkkzXwe6sRNw1616662221322.m3u8",
                "filename": "",
                "filesize": "0",
                "ext": "",
                "length": "5",
                "type": "video",
                "storage": "aliyun",
                "status": "1",
                "create_time": 1616662221000,
                "update_time": 1616662225000
            },
        ],
        "has_more": 1
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
list Array 返回的用户列表
uuid String 素材唯一ID，最大长度36字符
object String 源文件路径
convert_object String 转码后文件路径
filename String 文件名，最大长度100字符
filesize Int 文件大小（字节）
ext String 文件后缀名
length Int 素材长度（音视频单位秒，文档类单位页）
type String 媒体类型（video视频audio音频document文档）
storage String 存储源（默认是oss）
status Int 课程发布状态：
-1 删除
0 未发布
1 已发布
2 关闭
create_time Int 创建时间，Unix时间戳，单位毫秒
update_time Int 更新时间，Unix时间戳，单位毫秒，如果status为-1或者2，此为最后操作时间
has_more Int 是否还有数据没返回：
1 还有
0 没有



创建素材库

请求方式：POST（HTTPS）
请求地址：https://oapi.soke.cn/file/create
参数说明：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
object String 是 源文件路径（oss文档路径）
dept_user_id String 是 用户dept_user_id（上传人员userid）
category_id String 是 分类id（通过素材库分类列表获取分类id）
convert_object String 是 转码后文件路径
filename String 是 文件名
filesize Int 是 文件大小（字节）
ext String 是 文件后缀名
length Int 是 素材长度（音视频单位秒，文档类单位页）
type String 是 媒体类型（video视频audio音频document文档）
storage String 是 存储源（默认是oss）

成功返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
      	//创建成功的文件uuid
        "uuid":"376053D7-73B6-44FE-8EF2-4A27E5CC81C6" 
    }
}



更新素材库

请求方式：POST（HTTPS）
请求地址：https://oapi.soke.cn/file/update
入参：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
uuid String 是 要更新的部门ID
dept_user_id String 是 用户dept_user_id
object String 否 源文件路径
convert_object String 否 转码后文件路径
filename String 否 文件名
filesize Int 否 文件大小（字节）
ext String 否 文件后缀名
length Int 否 素材长度（音视频单位秒，文档类单位页）
type String 否 媒体类型（video视频audio音频document文档）
storage String 否 存储源（默认是oss）
status Int 否 课程发布状态：
-1 删除
0 未发布
1 已发布
2 关闭

成功返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": []
}
标签
作业