接口功能介紹

通過本接口可創建一個水印模板配置。

接口約束

注意：水印模板需要事先上傳水印圖片至云點播，因此，調用該接口需要3步：

1. 傳遞創建水印模板的基本參數。
2. 成功之后，云點播服務返回參數中帶一個 presigned 的 url 地址。使用該地址將圖片上傳到云點播。上傳使用方法可參考文檔使用預簽名URL直傳。
3. 上傳成功后，通過一個接口通知點播服務圖片上傳完成。

本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。

URI

POST /template/watermark/create

請求體 body 參數

表 position

響應參數

表 data

請求示例

{
  "name": "",
  "favorite": true,
  "remark": "我的水印",
  "position": {
    "top": "10%",
    "bottom": "10px",
    "left": "10%",
    "right": "10%",
    "height": "10%",
    "width": "10%"
  }
}

響應示例

{
    "code": 0,
    "message": "",
    "data" : {
        "templateId" : 100000000004,
        "presignedUrl": "//watermark-uuidxxx.gdoss.xstore.daliqc.cn/xxxxxx?signature=xxxxxx"
    }
}

狀態碼

錯誤碼

OpenAPI錯誤碼請參考 錯誤碼說明。