文件添加数字水印
接口地址 /v1/files/batchAddWatermark
请求方式 POST
接口描述 批量文件添加数字水印,一份文件一次仅可添加一种样式的数字水印,建议文件中不要存在大量图片,因数字水印图片默认放在文件图片下方,使用数字水印APP扫描时,图片区域会看不到水印信息。 (如数字水印图片放在图片上方,则文件打印后,图片上方会显示出数字水印图片,起不到防伪作用,因此默认放在文件图片下方),打印时必须彩打,对硬件的要求:彩色打印机精度越高越好,推荐最高分辨率1200*1200dpi以上;纸张质量越好,效果越好;彩色打印机墨盒尽可能保证原墨;打印时,选项中必须勾选”打印背景和图像”。
请求参数
参数名 | 说明 | 是否必填 | 参数类型 | ||
---|---|---|---|---|---|
files | 文件信息开始 | 是 | array | ||
fileId | 文件id | 是 | string | ||
watermarkInfo | 水印信息 | 是 | object | ||
contentType | 1:原图fileId ;2:原图base64; 3:文字 | 是 | int | ||
content | 水印内容:原图fileId/原图base64/文字, 1:文字最高32个字符;2:当传入内容为图片时,建议不超过200K,图片越大,添加时间越长; | 是 | string | ||
fontSize | 当content传入的是文字时,可指定文字大小,范围10-50号, 默认40 | 否 | int | ||
fontName | 当content传入的是文字时,可指定字体,支持如下字体,黑体 simhei 、普惠体 puhuiti、 宋体 simsun,默认黑体 | 否 | string | ||
imageHeight | 当content传入的是文字时,可以指定生成的水印图片固定高,300-600,默认根据文字大小自适应水印图片高 | 否 | int | ||
imageWidth | 当content传入的是文字时,可以指定生成的水印图片固定宽,300-600,默认根据文字大小自适应水印图片宽 | 否 | int | ||
rotationAngle | 当content传入的是文字时,可指定生成的水印图片旋转角度 ,正数为顺时针旋转,负数为逆时针旋转 | 否 | int | ||
scaling | 当content传入的是图片时,可以缩放生成的水印图片比例, 默认是100%,原尺寸大小 | 否 | int | ||
vmModel | 生成的水印图片渲染模式: 1描边 、2实心 ,默认实心, 当content传入的是文字时,字体推荐:黑体、宋体 | 否 | int | ||
lineWidths | 生成的水印图片在描边模式下,选择描边的粗细。范围为1~4,默认为3 | 否 | int | ||
alpha | 生成的水印图片透明度,1-255 值越大,打印出的文件越容易肉眼辨识水印图片,默认135 | 否 | int | ||
strength | 生成的水印图片强度,240-253 ,值越大,打印出的文件越难肉眼辨识水印图片,默认240 | 否 | int | ||
posBean | 水印图片位置信息(不传默认所有页平铺,传posPage不传x,y在指定页平铺,传x,y指定位置) | 否 | object | ||
posPage | 页码信息,默认全部文件,可以','或'-'分割 | 否 | string | ||
posX | 默认平铺全部 | 否 | float | ||
posY | 默认平铺全部 | 否 | float | ||
notifyUrl | 水印图片全部添加完成回调地址 | 否 | string | ||
thirdOrderNo | 三方流水号(唯一),有回调必填 | 否 | string |
请求示例
{
"files": [
{
"fileId": "",
"watermarkInfo": {
"contentType": 3,
"content": "水印文字",
"fontSize": 10,
"fontName": "simsun",
"vmModel": 1,
"lineWidths": 3,
"alpha": 100,
"strength": 250,
"imageHeight": 400,
"imageWidth": 400,
"scaling": 100,
"rotationAngle": 0
},
"posBean": {
"posPage": "1-10,20",
"posX": 11.5,
"posY": 200
}
}
],
"notifyUrl": "",
"thirdOrderNo": ""
}
响应参数
参数名 | 说明 | 类型 |
---|---|---|
code | 0正常 其他异常 | int |
message | 消息 | string |
data | 返回数据 | object |
响应示例
无
错误码