图片嵌入暗水印（文件地址版本）
功能介绍
对指定存储地址信息（目前支持OBS）的图片嵌入文字暗水印或者图片暗水印，已嵌入的水印的图片将存放在用户指定的位置（目前支持OBS），支持的图片格式为：*.jpg, *.jpeg, *.jpe, *.png, *.bmp, *.dib, *.rle, *.tiff, *.tif, *.ppm, *.webp, *.tga, *.tpic, *.gif。
URI
POST /v1/{project_id}/image-address/watermark/embed
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务“获取用户Token接口”获取（响应消息头中X-Subject-Token的值） |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| region_id | 是 | String | 当前项目所在region的id，如：xx-xx-1。 |
| src_file | 是 | String | 待加暗水印的图片地址，当前只支持OBS文件，格式为 obs://bucket/object ，其中bucket为和当前项目处于同一区域的OBS桶名称，object为对象全路径名。例如：obs://hwbucket/hwinfo/hw.png，其中obs://表示OBS存储，hwbucket为桶名，hwinfo/hw.png为对象全路径名。 |
| blind_watermark | 否 | String | 待嵌入的文字暗水印内容，长度不超过32个字符。当前仅支持数字及英文大小写。与图片暗水印image_watermark二选一。 |
| image_watermark | 否 | String | 待嵌入的图片暗水印地址，格式要求同src_file字段，与文字暗水印 blind_watermark 二选一，都填写时，生效image_watermark。 |
| dst_file | 否 | String | 添加水印后的图片存放的地址，格式要求同src_file字段，不设置时，默认取src_file的值，即添加水印后覆盖原文件。 |
响应参数
状态码： 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| region_id | String | 当前项目所在region的id，如：xx-xx-1。 |
| watermarked_file | String | 添加水印后的OBS图片地址，当前只支持OBS文件，格式为 obs://bucket/object ，其中bucket为和当前项目处于同一区域的OBS桶名称，object为对象全路径名。例如：obs://hwbucket/hwinfo/hw.png，其中obs://表示OBS存储，hwbucket为桶名，hwinfo/hw.png为对象全路径名。 |
状态码： 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误信息 |
请求示例
POST /v1/{project_id}/image-address/watermark/embed HTTP/1.1
{
"region_id" : "xx-xx-1",
"src_file" : "obs://hwbucket/test.png",
"blind_watermark" : "testWaterMark"
} 响应示例
状态码： 200
请求成功
{
"region_id" : "xx-xx-1",
"watermarked_file" : "obs://hwbucket/test.png"
} 状态码： 400
无效请求
{
"error_code" : "DSC.00000007",
"error_msg" : "File format error"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 无效请求 |
错误码
请参见错误码。
