平台自身PDF文件流签署（印章标识）

接口描述

使用项目编号绑定的账户完成接入系统本地指定文档的签署。

注：文件一旦签名盖章就不可以再进行任何填写或修改操作，否则在验证签署文件有效性时会显示文件被篡改，请在签章前完成所有内容填充。

文件涉及2个及以上签章时，请注意保留待签署文件流和每次签署后的文件流（含中间过程生成的文件流），方便在签署过程中出现失败时如何选择基于哪份文件的流进行重签。

接口

SelfSignService.localSignPDFV2(SignPDFStreamBean stream,    PosBean signPos, String sealId, SignType signType)

请求参数

展开全部参数参数名称		类型	必选	长度	参数说明	示例值
sealId		String	是		签署印章的标识，为0表示用默认印章签署 注意： 印章数据要和账户信息对应，否则会出现签署的印章和背后的数字证书不一致的情况，从而造成签署纠纷
signType		SignType	是		签章类型 （1）Single，单页签章 （2）Multi，多页签章 （3）Edges，签骑缝章 （4）Key，关键字签章
stream		SignPDFStreamBean	是		签署PDF文档信息
	stream	byte[]	是		待签署文档本地二进制数据
	fileName	String	否	255	文档名称，e签宝签署日志对应的文档名，若为空则取文档路径中的名称
	ownerPassword	String	否	100	文档编辑密码，当目标PDF设置权限保护时必填
	dstPdfFile	String	否	255	签署后PDF文档本地路径，含文档名（为空时返回签署后的文件流）
signPos		PosBean	是		签章位置信息
	posType	int	否		定位类型，0-坐标定位，1-关键字定位，默认0，SignType为关键字签署的时候，为1，否则为0。用户可以不作处理。此处只是为了兼容旧版本而保留
	posPage	String	否	25	签署页码，若为多页签章，支持页码格式“1-3,5,8“，若为坐标定位时，不可空
	posX	float	否		签署位置X坐标，若为关键字定位，相对于关键字的X坐标偏移量，默认0
	posY	float	否		签署位置Y坐标，若为关键字定位，相对于关键字的Y坐标偏移量，默认0
	key	String	否	30	关键字，仅限关键字签章时有效，若为关键字定位时，不可空；关键字建议不要设置特殊字符，因Adobe无法识别部分符号，某些特殊字符会因解析失败从而导致搜索不到
	width	float	否		印章展现宽度，将以此宽度对印章图片做同比缩放。        1)   为空： 若图片宽度超过159，印章宽度等比缩小至159； 若图片宽度小于159，印章尺寸默认以图片大小为准；        2)  不为空 印章宽度以传入参数为准。
	QrcodeSign	boolean	否		是否是 二维码签署，默认为false。二维码签署不支持骑缝签和多页签
	cacellingSign	boolean	否		是否是作废签签署，默认为false
	AddSignTime	boolean	否		是否显示本地签署时间，需要width设置92以上才可以看到时间

响应参数

展开全部参数参数名称		类型	必选	长度	参数说明	示例值
FileDigestSignResult		FileDigestSignResult	是		详见对象解释
	errCode	int	是		错误码，0标识成功，其他均标识失败
	msg	String	否	100	错误信息，错误码对应的说明信息
	errorShow	boolean	否		错误信息是否建议显示
	stream	byte[]	否		完成签署的文档二进制数据
	signDetailUrl	String	否		签署信息电子版链接
	signServiceId	String	否	40	签署记录id
	filePath	String	否		签署文档源路径
	dstFilePath	String	否		签署后目标路径
	markBit	String	否		客户自由标示位，用于辨识文件

请求示例  

其他示例语言请点击

	public static void main(String[] args) {

		// 获取正式生成服务
		// 获取客户端的代码：ServiceClient getKHD = ServiceClientManager.get("您的pojectId");
		// PDF摘要签署服务
		SelfSignService selfSignService = getKHD.selfSignService();
		/**
		 * 平台自身PDF摘要签署（文件流&印章标识）
		 */
		// 签署文档信息
		SignPDFStreamBean stream = new SignPDFStreamBean();
		stream.setStream(getFileBytes("D:/test-template.pdf"));
		stream.setDstPdfFile("D:/abc/c.pdf");// 签署后PDF文档本地路径，含文档名（为空时返回签署后的文件流）
		stream.setFileName("c");// 文档名称，e签宝签署日志对应的文档名，若为空则取文档路径中的名称

		PosBean signPos = new PosBean();
		signPos.setPosType(1);// 定位类型，0-坐标定位，1-关键字定位，默认0，SignType为关键字签署的时候，为1，否则为0。用户可以不作处理。此处只是为了兼容旧版本而保留
		signPos.setPosPage("1-3");// 签署页码，若为多页签章，支持页码格式“1-3,5,8“，若为坐标定位时，不可空
		signPos.setPosX(60L);// 签署位置X坐标，若为关键字定位，相对于关键字的X坐标偏移量，默认0
		signPos.setPosY(0);// 签署位置Y坐标，若为关键字定位，相对于关键字的Y坐标偏移量，默认0
		signPos.setKey("杭州天谷");// 关键字，仅限关键字签章时有效，若为关键字定位时，不可空
		// signPos.setCacellingSign(true);//是否是作废签签署，默认为false;如果签署作废章的话，建议线下也签署一份作废协议，这样法律效力较高
		signPos.setAddSignTime(true);// 是否显示本地签署时间，需要width设置92以上才可以看到时间

		FileDigestSignResult fileDigestSignResult = selfSignService.localSignPdfV2(stream, signPos, "0", SignType.Key);
		if (fileDigestSignResult.getErrCode() != 0)
			System.out.println("平台自身PDF摘要签署（文件流&印章标识）失败：" + JSONObject.fromObject(fileDigestSignResult));
		else
			System.out.println("平台自身PDF摘要签署（文件流&印章标识）成功" + JSONObject.fromObject(fileDigestSignResult));

	}

	/**
	 * description 获取文件字节流
	 * 
	 * @param filePath 文件路径
	 **/
	public static byte[] getFileBytes(String filePath) {
		File file = new File(filePath);
		FileInputStream fis = null;
		byte[] buffer = null;

		try {
			fis = new FileInputStream(file);
			buffer = new byte[(int) file.length()];
			fis.read(buffer);
		} catch (Exception e) {
			e.printStackTrace();
		} finally {
			if (fis != null) {
				try {
					fis.close();
				} catch (IOException e) {
					e.printStackTrace();
				}
			}
		}
		return buffer;
	}

响应示例

{
    "dstFilePath":"D:\abc\c.pdf",
    "errCode":0,
    "errShow":false,
    "filePath":"",
    "markBit":"",
    "msg":"成功",
    "signDetailUrl":"https://smlweb.tsign.cn/e.html?id=1173487759726301191",
    "signServiceId":"1173487759726301191",
    "stream":[

    ]
}

错误码