调用SubmitImageCopyright提交图片版权水印任务。
使用说明
- 本接口目前仅支持华东2(上海)地域使用。
- 本接口目前仅支持设置平铺水印,需要填写Params、Output和Message三个参数。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
POST /submitImageCopyright HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
Object | Body | 否 | 请求参数。 |
||
Level | Long | Body | 否 | 2 | 水印强度,取值范围[1,3]。 |
Message | String | Body | 是 | 平头哥半导体公司 | 水印信息。 |
Output | String | Body | 否 | {"Bucket":"abc-test","Location":"oss-cn-shanghai","Object":"out.jpeg"} | 水印图片输出OSS地址。 说明 OSS的地域需要与当前MPS所在地域保持一致。 |
Params | String | Body | 否 | {"width":2999, "height":2999, "afa": 3, "type":1, "version":0} | 水印参数。参数说明:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Object | 返回数据。 |
|
JobId | String | bfb786c639894f4d80648792021e**** | 任务ID。 |
Message | String | ok | 返回信息。 |
RequestID | String | 61038671443432952925C670 | 请求ID。 |
StatusCode | Long | 200 | 状态码。 |
示例
请求示例
POST /submitImageCopyright HTTP/1.1
Host:mts.aliyuncs.com
Content-Type:application/json
{
"Level" : 2,
"Message" : "平头哥半导体公司",
"Output" : "{\"Bucket\":\"abc-test\",\"Location\":\"oss-cn-shanghai\",\"Object\":\"out.jpeg\"}",
"Params" : "{\"width\":2999, \"height\":2999, \"afa\": 3, \"type\":1, \"version\":0}"
}
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SubmitImageCopyrightResponse>
<Data>
<JobId>bfb786c639894f4d80648792021e****</JobId>
</Data>
<Message>ok</Message>
<RequestID>61038671443432952925C670</RequestID>
<StatusCode>200</StatusCode>
</SubmitImageCopyrightResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Data" : {
"JobId" : "bfb786c639894f4d80648792021e****"
},
"Message" : "ok",
"RequestID" : "61038671443432952925C670",
"StatusCode" : 200
}
错误码
访问错误中心查看更多错误码。