更新水印模板

最近更新时间:2019-02-19 16:29:15

接口名称

UpdateWatermarkTemplate

功能说明

  1. 更新水印模板。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
definition Integer 采样截图模板ID
type String 水印类型,固定为image
url String 水印的 url 地址
left String 水印图片左上角距离视频图像左上角的水平位置。
  • 带%结尾的字符串表示水印 left 为视频宽度百分比的大小,如10%表示 left 为视频宽度的10%;
  • 带 px 结尾的字符串表示 left 单位为像素,100px 表示 left 为100像素;
默认为 0px
top String 水印图片左上角距离视频图像左上角的垂直位置。
  • 带%结尾的字符串表示水印 top 为视频高度百分比的大小,如10%表示 top 为视频宽度的10%;
  • 带 px 结尾的字符串表示top单位为像素,100px表示 top 为100像素
默认为 0px
width String 水印图片的宽度。
  • 带%结尾的字符串表示 width为视频宽度百分比的大小,如10%表示 width 为视频宽度的10%;
  • 带 px 结尾的字符串表示 width 单位为像素,100px 表示 width 为100像素;
默认为10%
height String 水印图片的高度。
  • 带%结尾的字符串表示水印 height 为视频高度百分比的大小,如10%表示 height 为视频高度的10%
  • 带 px 结尾的字符串表示 height 单位为像素,100px表示 height 为100像素;
默认为 0px,表示 height 按照对视频的 width 的比例缩放
COMMON_PARAMS 参见公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=UpdateWatermarkTemplate
&definition=10005
&name=test
&type=image
&url=www.watermark.com/test.jpg
&width=10%
&left=20px
&top=30px
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码, 0: 成功, 其他值: 失败
message String 错误信息

错误码说明

错误码 含义说明
4000-7000 参见公共错误码
1000 无效参数
10801 请求中的url参数错误
10802 请求中的type参数错误
10803 请求中的left参数错误
10804 请求中的top参数错误
10807 请求中的definition参数错误
10810 请求中的width参数错误
10811 请求中的height参数错误

应答示例

{
    "code": 0,
    "message": ""
}