图片嵌入暗水印
功能介绍
对图片嵌入文字暗水印或者图片暗水印,用户以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 |
无效请求 |
错误码
请参见错误码。