文件添加数字水印

接口地址 /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

响应示例

错误码

results matching ""

    No results matching ""