短信验证批量签署

更新时间:2021-11-19 18:31:42

接口描述

用指定账户的证书批量签署文档(最大为1000份文档),此签署过程不将文档上传至e签宝平台,只传递文档摘要信息。签署过程需要校验用户短信验证码,验证码必须通过e签宝接口发送。

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

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

接口

http://ip:port/tech-sdkwrapper/timevale/sign/codeMultiSign

请求方式

POST

请求参数

展开全部参数参数名称

类型

必选

参数说明

示例值

accountId

string

签署者账号标识,以此获取账户的证书进行其拿书


sealData

string

印章图片base64


code

string

短信验证码,通过e签宝接口发送


signParams

list

签署列表信息





signType

string

签章类型,

Single(单页签章)

Multi(多页签章)

Edges(签骑缝章)

Key(关键字签章)


fileBean

json

签署文件信息


srcPdfFile

string

待签署PDF文档本地路径


dstPdfFile

string

签署后PDF文档本地路径


fileName

string

文档名称


ownerPassword

string

文档编辑密码


signPos

json

签署区信息


posPage

string

签署页码, 若为多页签章,支持页码格式“1-3,5,8“, 坐标定位时不可空


posType

int

定位类型,0坐标定位,1关键字定位,默认0(若为关键字定位,签章类型(signType)必须指定为关键字定位才生效)


key

string

关键字


posX

float

签署位置X坐标


posY

float

签署位置Y坐标


width

float

印章展现高度


qrcodeSign

boolean

是否是 二维码签署,默认为false。二维码签署不支持骑缝签和多页签


响应参数

展开全部参数参数名称

类型

必选

参数说明

示例值

errCode

int

错误码


msg

string

错误信息


errShow

boolean

错误信息是否显示


successList





errCode

int

错误码


msg

string

错误信息


errShow

boolean

错误信息是否显示


signServiceId

string

签署记录id


filePath

string

源文档路径


failList





errCode

int

错误码


msg

string

错误信息


errShow

boolean

错误信息是否显示


signServiceId

string

签署记录id


filePath

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": []
}

错误码

错误码

错误描述

解决方案


我要纠错