PDF《ONAIR 视频云》

2 第一部分是具体接口服务的接口地址,由接口服务根据一定规则(按照不同功能进行命 名上的区分)自定义,第二部分为公共参数,在调用每个接口时均需填入该部分. 1.3 返回结果 { code : 0, #状态码,参照附录 message : success , #描述信息 data : { requestId : 45123875-5F38-4W33-BER5-D7345672CA58 } #结果数据 } 视频云点播服务接口调用规范 第2章 文件上传接口 2.1 获取视频文件上传令牌 功能描述 根据用户提供的视频名称、视频大小(字节数),获取素材断点续传的上传令牌. 请求参数 名称 类型 说明 必填 materialName String 视频名称,需要包含后缀名(会作为文件上 传完成之后的后缀名),长度不超过

128 个 字节;

后缀名支持:*.avi;

*.dv;

*.flv;

*.mp4;

*.swf;

*.mxf;

*.rm;

*.m4v;

*.ts;

*.3gp;

*.hls;

*.m3u8;

*.ogg;

*.vob;

*.3g2;

*.webm,... ;

是materialLength Long 视频大小,单位:字节 是title String 视频标题,长度不超过

128 个字节,不填默 认为视频名称 否description String 视频描述,长度不超过

512 个字节,不填写 默认为空 否cateId String 视频分类 ID,不填写默认为空 否coverURL String 自定义视频封面 URL 地址,不填写默认为空 否templateGroupId String 转码模板组 ID,不填写时会选用默认模板组 ID 进行转码处理 注: 系统自带两个模板组(不转码即分发模板 组和系统标清模板组),默认使用系统标清 模板组进行标准转码 否snapshotId String 截图模板 ID,不填写时不进行截图 否censoredId String 审核模板组 ID,支持鉴黄、涉政、暴恐识 别,当为空时不进行视频审核服务 否tags String 视频标签 单个标签不超过

32 字节. 多个用逗号分隔. 最多不超过

16 个标签. 标签内容需使用 UTF8 进行编码. 否 返回参数 参数 类型 说明 视频云点播 API 接口调用规范

4 uploadDomain String 获取文件大小及文件上传服务对应接口的 URI (如: http://vodupload.yunshicloud.com) uploadToken String 上传令牌 requestId String 请求 ID 调用示例 请求示例: http(s)://[域名]/token/createUploadFileToken?version=V1&

materialName=测试视频.mp 4&

materialLength=52113140 返回示例: { code : 0, message : success , data : { uploadToken : 1630DDC50D23445BBA7B914E9756CF64 , uploadDomain : http://vodupload.yunshicloud.com , requestId : x-request-xiaodai-test } } 2.2 视频上传完成回调 功能描述 当在回调配置里配置了回调地址且置为开启状态后系统在视频上传完成和视频处理完 成后会主动回调. 视频上传完成回调请求参数 名称 类型 说明 FILE_TYPE String 视频上传固定值为 FILE ACTION String 视频上传完成固定值为 UPLOAD_FINISH RESULT String 上传成功为 SUCCESS,上传失败为 FAILURE UPLOAD_TOKEN String 上传 token ACTION_CONTENT JSON JSON 对象,上传完成后创建的素材,当上传成功时 包含该字段,参考 5.1.22 附录-数据类型-MaterialFile 视频上传完成回调示例: { code : 0, message : 处理成功 , data : { 视频云点播 API 接口调用规范

5 ACTION_CONTENT : { materia........