服务端 API 文档

申请上传水印文件

最近更新时间:2019-12-02 15:53:18

注意:

本接口已不再维护,新接口 CreateWatermarkTemplate 为您提供更完备的功能,请尽快迁移。

接口名称

ApplyUploadWatermark

功能说明

在创建水印模板时,通过本接口获取水印文件的上传 URL。

说明:

通过服务端 API 创建水印模板步骤如下:

  1. 调用本接口,申请水印文件的上传 URL。
  2. 使用 HTTP PUT 方法,将水印文件上传到上一步返回的上传 URL,请求 BODY 为水印图片的二进制数据。
  3. 调用 创建水印模板(CreateWatermarkTemplate)接口,创建水印模板。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
type String 水印文件类型,如 JPG 或 PNG 等。推荐使用 PNG 格式。
COMMON_PARAMS - 请参见 公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=ApplyUploadWatermark
&type=png
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码,0:成功;其他值:失败。
message String 错误信息。
uploadUrl String 上传水印文件的地址。

错误码说明

错误码 含义说明
4000 - 7000 请参见 公共错误码
1000 无效参数。
1001 用户信息错误。

应答示例

{
    "code": 0,
    "message": "",
    "uploadUrl":"http://123.test.com/123.png&sign=abcd"
}
目录