服务端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",
                "category_id": "1C09EBF2-A8D9-4BDF-8D60-FADE743E1508",
                "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字符
category_id 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 没有



获取素材库详情

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

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
file_id String 是 素材库资源id

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "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
    }
}

参数说明：

参数 类型 说明
data 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，此为最后操作时间



获取素材库下载链接

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

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
uuid String 是 素材库资源id

注意：下载会耗用企业流量（管理后台首页企业流量总额度），如果企业可用流量为0会提示无法返回正确的下载链接，请联系管理员购买流量 返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "url": "https://www.downurl.com/dingc4cffb655c00d67f35c2f4657eb6378f/course/video/dcEwKkkzXwe6sRNw1616662221322.mp4",
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
url String 下载url（有效时长30分钟，过时需要重新请求下载地址）
用户组
作业