接口功能介绍

通过本接口可在点播模式下创建一个视频条目。

由于视频文件的存储是在媒体存储（原 对象存储融合版），而管理信息在云点播服务，因此我们需要3步来进行文件上传。

步骤1：初始化上传，在此步骤需要将所有的业务管理信息发送到云点播服务中创建视频文件接口，接口成功之后会返回分片上传的地址列表，如下文响应示例所示。

调用了该接口但未调用完成上传视频接口，系统会在数据库中存入这些业务信息（以及一些中间信息，例如uploadId），但由于这条视频信息还处于 UPLOADING的状态，除了删除视频外的其他接口，均不会对这些视频造成影响。例如在提交任务接口中，甚至会返回找不到该视频的错误。

步骤2： 将视频文件片上传到步骤1返回的URL列表中。

将完整的视频按照步骤1约定的大小进行切片，然后将片段按照顺序使用 data.uploadUrls 中返回的预签名 URL 上传到服务器。signature签名可以参考签名应用及示例中SHELL实例。例如：

PUT https://example.xstore.ctyun.cn/Objectname/uploadPart?partNum=1signature=xxxxxx

步骤3. 调用云点播服务上传视频接口完成本次上传。步骤2每次上传成功之后，需要记录请求 Response 中的 eTag 头部信息，在步骤3完成上传视频的接口参数中传入该参数。

接口约束

本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

URI

POST /video/create

请求体body参数

表 fileInfo

响应参数

表data

请求示例

{   
    "name": "videoNmae",
    "regionCode": "xs-shanghai-1",
    "remark": "",
    "tags": ["爱情片", "历史片"],
    "fileInfo": {
        "fileSize": 1024000,
        "partSize": 5242880,
        "md5": ""
    },
    "categoryId"：10000600056
}

响应示例

{
    "code": 0,
    "message": "",
    "data" : {
        "videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
        "uploadUrls": ["https://example.xstore.ctyun.cn/Objectname/uploadPart?partNum=1signature=xxxxxx",
                       "https://example.xstore.ctyun.cn/Objectname/uploadPart?partNum=2signature=xxxxxx"]
    }
}

状态码

错误码

OpenAPI错误码请参考 错误码说明。