PDF模板发起
接口说明
[!NOTE]
通过PDF模板发起合同接口可以发起: 半自动签署,手动签署(用户有感知),自动签署(用户无感知),保全存证,hash保全,批量签署合同等多种合同类型。1、接口对签署人为个人时,不会校验姓名+身份证号+手机号的真实性,需要开发者确保真实性;君子签可单独提供个人身份证二要素、运营商三要素等的校验接口,需要联系商务充值后才能使用。
2、接口中签署人信息(证件号)不能重复,同一个签署人可以设置多个签字位置,可以针对不同签署人分别设置验证方式(人脸,银行卡,短信验证码等)、签署方式(自动签、手动签)等。
3、该调用接口成功后返回APL开头的合同编号,开发者需要保存该合同编号,以便后续接口调用。
4、签字位置设置说明:接口支持PDF文件关键字定位,坐标(X,Y)定位,表单域(HTML、君子签后台设置API模板),详细说明可参考“签字位置指定”说明
http请求方式
[!NOTE]
POST multipart/form-data
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/fileTpl/applySign #其中$SERVICE_URL为生产或测试的地址
http请求参数
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| fileType | int | * | 0 | 合同上传方式:2tmpl模版生成; |
| templateNo | string | + | 合同模版编号,dealType!=6,fileType=2,时必须传入 | |
| templateParams | JSONString | + | 合同模版参数JSON字符串,fileType=2,时必须传入 | |
| 其它参数说明参考“签约发起-文件类API” |
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| success | bool | * | 成功true;异常false |
| msg | string | ? | 异常时,返回异常原因 |
| resultCode | string | ? | 异常时返回 |
| data | string | ? | 合同编号信息(APLXXXXX) |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":"APL17275928060XXXXX0","msg":"操作成功","success":true}
//错误响应:
{"msg":"TT测试公司,chapteJson签字位置不能为空","resultCode":"HTTP_PARAM_ERROR","success":false}