# 视频

# 创建视频

此接口只用于创建视频实体,不负责文件传输。开发者需先通过 视频分片上传 接口将文件上传于腾讯云,此接口创建video实体。

# 接口调用说明

POST https://lxapi.lexiangla.com/cgi-bin/v1/videos
headers.Authorization:  Bearer {access_token}
headers.StaffID: {StaffID}

# 请求document

{
    "data":{
        "type":"video",
        "attributes":{
            "vod_file_id":"your_vod_file_id",
            "name":"视频名称",
            "type":"mp4"
        }
    }
}

# 参数说明:

参数 是否必须 默认值 说明
vod_file_id 视频分片上传中获取的data.fileId
name 视频名称,同步骤视频分片上传中文档videoName说明
type 视频的文件类型,同步骤视频分片上传中文档videoType说明
size 视频的文件大小,同步骤视频分片上传中文档videoSize说明

# SDK封装方法使用示例:

$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$file_path = './345.mp3'; // 文件的绝对路径
$cover_path = '';
$response = $Lxapi->uploadVideo('ThreeZhang', $file_path, $cover_path);

# 响应document

{
    "data":{
        "type":"video",
        "id":"756972cefac711e9b51e10e7c61c70fc",
        "attributes":{
            "name":"视频名称",
            "type":"mp4",
            "vod_file_id": "your_vod_file_id"
        }
    }
}

# 获取单个视频信息

# 接口调用说明:

GET https://lxapi.lexiangla.com/cgi-bin/v1/videos/{id}

# 参数说明:

参数 是否必须 默认值 说明
id video ID

# SDK封装方法使用示例:

$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$response = $Lxapi->get('videos/6f230e7e7df911eaa5b40242ac180005');

# 响应document

# 200 OK 状态码
{
    "data": {
        "type": "video",
        "id": "6f230e7e7df911eaa5b40242ac180005",
        "attributes": {
            "name": "测试视频",
            "type": "MP4",
            "vod_file_id": "5285890801312622820"
        },
        "links": {
            "download": "http://1400311082.vod2.myqcloud.com/ff2d1f96vodcq1400311082/3708a57d5285890801312622820/ui4eR9aGRTQA.mp4?t=5e953515&us=csd6yo7sbt&sign=239fa8c9c877fdee7264b6d65bb636c1"
        }
    }
}

# 参数说明:

参数 说明
name 视频名称
type 视频类型
vod_file_id 内部存储ID
links.download 视频下载地址,有效期1小时