图片嵌入暗水印
功能介绍
对图片嵌入文字暗水印或者图片暗水印,用户以formData的格式传入待加水印图片和水印相关信息,DSC服务对图片加完水印后返回给用户已嵌入水印的图片二进制流,目前支持的图片格式为:*.jpg, *.jpeg, *.jpe, *.png, *.bmp, *.dib, *.rle, *.tiff, *.tif, *.ppm, *.webp, *.tga, *.tpic, *.gif。
URI
POST /v1/{project_id}/image/watermark/embed
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务“获取用户Token接口”获取(响应消息头中X-Subject-Token的值) |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| file | 是 | File | 要添加水印的图片文件,添加的图片短边尺寸需要超过512像素。 |
| blind_watermark | 否 | String | 待嵌入的文字暗水印内容,长度不超过32个字符。当前仅支持数字及英文大小写。与图片暗水印image_watermark二选一填充。 |
| image_watermark | 否 | File | 待嵌入的图片暗水印文件,与文字暗水印 blind_watermark 二选一填充。 |
响应参数
状态码: 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误信息 |
请求示例
通过form表单提交,file为具体文件。
POST /v1/{project_id}/image/watermark/embed HTTP/1.1
{
"blind_watermark" : "testWaterMark",
"file" : "test.PNG"
} 响应示例
状态码: 200
请求成功
"{\"Watermarked image\"}" 状态码: 400
无效请求
{
"error_code" : "DSC.00000007",
"error_msg" : "File format error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 无效请求 |
错误码
请参见错误码。