PDF《ONAIR 视频云》

ONAIR 视频云 点播 API 接口调用规范 版本号:V2.

0.3 北京阳光云视科技有限公司

2019 年1月I目录第1章接口定义说明

1 1.1 概述.1 1.2 请求结构说明

1 请求地址.1 公共参数.1 地址示例.1 1.3 返回结果.2 第2章文件上传接口

3 2.1 获取视频文件上传令牌.3 功能描述.3 请求参数.3 返回参数.3 调用示例.4 2.2 视频上传完成回调.4 功能描述.4 视频上传完成回调请求参数

4 视频处理完成回调请求参数

5 2.3 获取图片文件上传令牌.8 功能描述.8 请求参数.8 返回参数.8 调用示例.8 2.4 图片上传完成回调.9 功能描述.9 图片上传完成后回调请求参数

9 2.5 获取已上传视频文件大小

10 功能描述.10 请求参数.10 返回参数.10 调用示例.10 2.6 文件上传.10 功能描述.10 II 请求参数.11 返回参数.11 调用示例.11 2.7 文件注册.12 功能描述.12 请求参数.13 返回参数.13 调用示例.13 2.8 直播内容接入

13 功能描述.13 请求参数.14 返回参数.14 调用示例.14 第3章视频管理接口

15 3.1 获取视频信息

15 功能描述.15 请求参数.15 返回参数.15 调用示例.15 3.2 修改视频信息

18 功能描述.18 请求参数.18 返回参数.18 调用示例.18 3.3 获取视频信息列表.20 功能描述.20 请求参数.21 返回参数.21 调用示例.21 3.4 获取源文件地址

24 功能描述.24 请求参数.24 返回参数.24 调用示例.24 III 3.5 删除视频文件

25 功能描述.25 请求参数.25 返回参数.25 调用示例.25 第4章全局设置接口

26 4.1 转码设置.26 新增转码组.26 更新转码组.27 查询转码组列表

28 查询转码组.30 删除转码组.31 设置默认转码组

32 查询转码模板

32 4.2 审核设置.33 新增审核模板

34 更新审核模板

35 查询审核模板列表

36 查询模板详情

38 删除审核模板

39 4.3 水印设置.39 新增水印模板

39 更新水印模板

40 查询水印详情

41 查询水印列表

42 删除水印模板

43 4.4 截图设置.44 新增截图模板

44 更新截图模板

45 查询截图详情

46 查询模板列表

47 删除截图模板

48 4.5 视频分类设置

49 新增分类.49 IV 修改分类.50 删除分类.50 获取分类及其子分类.51 4.6 回调设置.53 设置回调地址

53 第5章附录

55 5.1 数据类型.55 TemplateGroup.55 TranscodeTemplate.55 WaterMarkTemplate.55 CensoredTemplate

56 SnapshotTemplate.56 Category.57 TranscodeInfo

57 TranscodeFile

57 SnapshotInfo.57 SnapshotFile

57 AuditInfo

58 AuditResult.58 AuditPoint.58 AuditLabel

58 MediaFile.59 MediaInfo

59 MediaInfoGeneral.59 MediaInfoVideo.59 MediaInfoAudio.60 MediaInfoPic.60 FileInfo

60 MaterialFile.60 TextWaterMark.61 CallbackConfig.61 5.2 参数详情.61 转码模板配置详情

61 水印模版配置详情

61 V 水印 Timeline 详情.62 截图 SnapshotConfig 详情.62 文字水印 TextWaterMark 参数详情.63 waterMarkTemplates 详情.63 5.3 FONTCOLOR 列表.63 第6章预置转码模板:67 第7章附录:69 视频云点播 API 接口调用规范

1 第1章 接口定义说明 1.1 概述 欢迎使用视频云点播服务. 用户可以使用本文档介绍的 API 规范, 完成点播相关接口的 对接工作.为了加强接口调用的安全和可控性,需要遵循 API 网关的验证规范. 服务接口调用统一采用标准的 RESTFul 风格的 API 形式,支持 HTTP GET 请求,请求 参数需要包含在请求的 URL 中,同时支持 HTTP POST 请求, 请求参数需要以表单 形式提交. 调用服务端统一 HTTP(S) 协议的请求, 为了获得更高的安全性, 推荐您使用 HTTPS 通 道发送请求.根据请求的处理情况,系统响应数据格式统一为 JSON 数据格式. 1.2 请求结构说明 请求地址 服务调用接口地址规则: https://[域名]/[接口地址]?[公共参数] 访问地址由三部分组成: 域名:接口服务部署后提供访问域名. 接口地址:接口服务根据实现功能的不同提供相应的地址. 公共参数:公共请求参数是指每一个接口都需要使用到的参数. 注:非必填项的值可以不传,所有请求参数区分大小写,命名遵循驼峰命名规则.请求 及返回结果都使用 UTF-8 字符集进行编码,请求参数需要先进行 urlEncode 编码 示例:URLEncoder.encode(value, UTF-8 ).replace( + , %20 ).replace( * , %2A ).replace( %7E , ~ ). 时间示例: 编码前:2018-03-05 21:07:49 编码后:2018-03-05%2b21%253a07%253a49 公共参数 地址示例 https:// dbapi.apistore.huaweicloud.com/api/log/v1/getLogs?version=V1 [ 第一部分 ][ 第二部分 ] 属性 含义 类型 说明 必填 version 版本号 String 目前固定填写 V1 是 视频云点播 API 接口调用规范