接口描述
用指定账户的证书批量签署文档(最大为1000份文档),此签署过程不将文档上传至e签宝平台,只传递文档摘要信息。签署过程需要校验用户短信验证码,验证码必须通过e签宝接口发送。
注:文件一旦签名盖章就不可以再进行任何填写或修改操作,否则在验证签署文件有效性时会显示文件被篡改,请在签章前完成所有内容填充。
文件涉及2个及以上签章时,请注意保留待签署文件和每次签署后的文件(含中间过程生成的文件),方便在签署过程中出现失败时如何选择基于哪份文件进行重签。
接口
http://ip:port/tech-sdkwrapper/timevale/sign/mobileMultiSign
请求方式
POST
请求参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | 示例值 | ||
accountId | string | 是 | 签署者账号标识,以此获取账户的证书进行其拿书 | |||
sealData | string | 是 | 印章图片base64 | |||
mobile | string | 是 | 接收短信验证码的手机 | |||
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 | 否 | 源文档路径 |
请求示例
请求参数示例:具体根据实际业务场景进行传参,此处仅为参考
请求数据采用json格式、UTF-8编码,请求数据类型Content-Type=application/json
POST http://localhost:8080/tech-sdkwrapper/timevale/sign/mobileMultiSign
localhost:8080这里参考https://qianxiaoxia.yuque.com/docs/share/7c96dfbc-1e53-4de3-b1f6-46e10eda67b4
{
"accountId": "xxxxxxxxxx40348C650779852C8B4E",
"mobile":"1826xxxxxxxxx",
"code": "686100",
"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=1182259684673933315",
"errCode": 0,
"filePath": "D:/test-template.pdf",
"errShow": false,
"signServiceId": "1182259684673933315"
}
],
"errCode": 0,
"errShow": false,
"failList": []
}
错误码
错误码 | 错误描述 | 解决方案 |