- 接口地址:https://FDDServer:Port/api/extsign_auto.api
- 接口类型:HTTP POST请求
- 调用方向:接入平台->法大大
- 接口说明:自动签接口不需要用户亲自操作，当接入平台调用此接口时，就会在指定的电子合同上签上指定用户的电子章，省略了用户交互的步骤。因此如果需要使用此接口的能力， 需要接入平台联系法大大商务签署补充协议。
输入参数
| 参数 | 要求 | 描述 | 备注 |
|---|---|---|---|
| app_id | 必选 | 接入方ID | |
| timestamp | 必选 | 请求时间 | yyyyMMddHHmmss |
| v | 可选 | 版本号 | 默认为2.0; 版本为2.1时，返回3DES处理后的下载/查看地址 |
| transaction_id | 必选 | 交易号 | 每次请求视为一个交易。只允许长度<=32的英文或数字字符。 交易号为接入平台生成，必须保证唯一并 自行记录。 |
| contract_id | 必选 | 合同编号 | 根据合同编号指定在哪份文档上进行签 署。 合同编号在文档传输或合同生成时设定。 |
| customer_id | 必选 | 客户编号 | CA注册时获取。 |
| client_role | 必选 | 客户角色 | 1-接入平台2-担保公司 3-投资人4-借款人如果需要开通自动签权限请联系法大大 的商务签署补充协议。 |
| doc_title | 必选 | 文档标题 | 如“xx投资合同” |
| position_type | 可选 | 定位类型 | 0-关键字(默认)1-坐标 |
| sign_keyword | 可选 | 定位关键字 | 关键字为文档中的文字内容(能被查找功 能检索到)。 法大大按此关键字进行签章位置的定位， 将电子章盖在这个关键字上面。凡出现关 键字的地方均会盖上指定用户的电子章， 建议关键字在合同中保持唯一。当position_type为0时，此参数必填 |
| keyword_strategy | 可选 | 关键字签章策略 | 关键字签章策略:0:所有关键字签章 (默认);1:第一个关键字签章 ;2:最后一个关键字签章; |
| signature_positions | 可选 | 定位坐标 | 类型:String格式:JsonArray<SearchLocation> 当position_type为1时，此参数必填 |
| notify_url | 可选 | 签署结果异步通 知URL | 如果指定，当签章完成后，法大大将向此URL发送签署结果。 参见签署结果异步通知规范(notify_url) |
| msg_digest | 必选 | 消息摘要 | Base64( SHA1(app_id +MD5(transaction_id+timestamp) +SHA1(app_secret+ customer_id)) ) |
SearchLocation属性说明
| 属性名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| pagenum | int | 页码 | 签章页码，从0开始。即在第一 页签章，传值0。 |
| x | double | 盖章点x坐标 | 盖章点x坐标,以左上角为原点0,0，取鼠标位置为图片中心点。 坐标请以图片宽度为800为基 准。 |
| y | double | 盖章点y坐标 | 盖章点y坐标,以左上角为原点0,0，取鼠标位置为图片中心点。 坐标请以图片高度为1131为基 准。 |
输出参数
| 参数 | 要求 | 描述 | 备注 |
|---|---|---|---|
| result | 必选 | 处理结果 | success:成功error:失败 |
| code | 必选 | 状态码 | 1000:操作成功2001:参数缺失或者不合法2002:业务异常，失败原因见msg 2003:其他错误，请联系法大大 |
| msg | 必选 | 描述 | |
| download_url | 可选 | 合同下载地址 | |
| viewpdf_url | 可选 | 合同查看地址 |