接口描述
用指定账户的证书批量签署文档(最大为1000份文档),此签署过程不将文档上传至e签宝平台,只传递文档摘要信息。签署过程需要校验用户短信验证码,验证码必须通过e签宝接口发送。
注:文件一旦签名盖章就不可以再进行任何填写或修改操作,否则在验证签署文件有效性时会显示文件被篡改,请在签章前完成所有内容填充。
文件涉及2个及以上签章时,请注意保留待签署文件和每次签署后的文件(含中间过程生成的文件),方便在签署过程中出现失败时如何选择基于哪份文件进行重签。
接口
http://ip:port/tech-sdkwrapper/timevale/sign/codeMultiSign
请求方式
POST
请求参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | 示例值 | ||
accountId | string | 是 | 签署者账号标识,以此获取账户的证书进行其拿书 | |||
sealData | string | 是 | 印章图片base64 | |||
code | string | 是 | 短信验证码,通过e签宝接口发送 | |||
![]() | list | 是 | 签署列表信息 | |||
![]() | string | 是 | 签章类型, Single(单页签章) Multi(多页签章) Edges(签骑缝章) Key(关键字签章) | |||
![]() | json | 是 | 签署文件信息 | |||
![]() | string | 是 | 待签署PDF文档本地路径 | |||
![]() | string | 是 | 签署后PDF文档本地路径 | |||
![]() | string | 否 | 文档名称 | |||
![]() | string | 否 | 文档编辑密码 | |||
![]() | json | 是 | 签署区信息 | |||
![]() | string | 否 | 签署页码, 若为多页签章,支持页码格式“1-3,5,8“, 坐标定位时不可空 | |||
![]() | int | 否 | 定位类型,0坐标定位,1关键字定位,默认0(若为关键字定位,签章类型(signType)必须指定为关键字定位才生效) | |||
![]() | string | 否 | 关键字 | |||
![]() | float | 否 | 签署位置X坐标 | |||
![]() | float | 否 | 签署位置Y坐标 | |||
![]() | float | 否 | 印章展现高度 | |||
![]() | boolean | 否 | 是否是 二维码签署,默认为false。二维码签署不支持骑缝签和多页签 |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | 示例值 | |
errCode | int | 是 | 错误码 | ||
msg | string | 否 | 错误信息 | ||
errShow | boolean | 否 | 错误信息是否显示 | ||
![]() | |||||
![]() | int | 是 | 错误码 | ||
![]() | string | 否 | 错误信息 | ||
![]() | boolean | 否 | 错误信息是否显示 | ||
![]() | string | 否 | 签署记录id | ||
![]() | string | 否 | 源文档路径 | ||
![]() | |||||
![]() | int | 是 | 错误码 | ||
![]() | string | 否 | 错误信息 | ||
![]() | boolean | 否 | 错误信息是否显示 | ||
![]() | string | 否 | 签署记录id | ||
![]() | string | 否 | 源文档路径 |
请求示例
请求参数示例:具体根据实际业务场景进行传参,此处仅为参考
请求数据采用json格式、UTF-8编码,请求数据类型Content-Type=application/json POST http://localhost:8080/tech-sdkwrapper/timevale/sign/codeMultiSign localhost:8080这里参考https://qianxiaoxia.yuque.com/docs/share/7c96dfbc-1e53-4de3-b1f6-46e10eda67b4 { "accountId": "1446040AF85440348C650779852C8B4E", "code": "271268", "signParams": { "signType": "Single", "fileBean": { "srcPdfFile": "D:/test-template.pdf", "dstPdfFile": "D:/abc/test-template.pdf" }, "signPos": { "posPage":"1" } } }
响应示例
{ "msg": "成功", "successList": [ { "msg": "成功", "dstFilePath": "D:/abc/test-template.pdf", "signDetailUrl": "https://smlweb.tsign.cn/e.html?id=1182259175053410310", "errCode": 0, "filePath": "D:/test-template.pdf", "errShow": false, "signServiceId": "1182259175053410310" } ], "errCode": 0, "errShow": false, "failList": [] }
错误码
错误码 | 错误描述 | 解决方案 |