基础介绍

当发起合同签署时，有两种用户签署模式可选择：

指定位置签章：接口提前指定固定签署位置，用户在签署页面直接点击签署在固定位置。

自由签章：接口不指定固定签署位置，用户在签署页面自由拖拽印章在任意位置签署。

开发者可以根据自身需求，选择用以上哪种方式。一般建议使用：指定位置签章方式。

开发者可以提前获得签字/盖章位置的XY坐标值，通过接口传入XY坐标值进行指定签署位置。

提前获取签署位置坐标参考方法：

e签宝接口获取方式：

获取拖章定位页面：接口获取e签宝的拖章定位页面，设置好后开发者可以在获取签章位置信息通知中接收位置坐标等信息；
检索文件关键字坐标接口：检索PDF文件中所含关键字的所有XY坐标信息。例如：关键字是“甲方签名处”，则通过接口查询检索PDF文件中所有出现“甲方签名处”的位置对应XY坐标值。

使用e签宝小工具：

盖章位置XY坐标值计算小工具：页面上传文件拖章，右侧显示坐标位置和页码信息。（适用于签署文件比较固定，不需要开发程序定位场景）

根据页面尺寸自己计算：

印章图片尺寸和坐标：根据页面和印章大小自己计算盖章的X、Y坐标。

效果展示

指定位置签章操作展示

自由签章操作展示

API接口

API接口（点击直接跳转相关API文档）	API描述	是否必需
基于文件发起签署	此接口用来发起签署，发起成功后会返回签署流程标识：signFlowId。	必需
获取签署页面链接	此接口获取签署方签署页面链接，可用于签署或预览。	按需

基于文件发起签署接口代码案例

相关参数

freeMode（是否自由签章）
movableSignField（页面是否可移动签章区）
signFieldStyle（签章区样式：1 - 单页签章，2 - 骑缝签章）
signFieldPosition（签章区位置信息）

指定位置签章--用户页面不可移动位置

freeMode 默认：false（非自由签章），可不传；
movableSignField 默认：false（不可移动签署区），可不传；
signFieldStyle 设置为：1（单页签章）；
signFieldPosition 内传入具体的页码，X坐标和Y坐标。

"signers": [
        {
            "signFields": [
                {
                    "normalSignFieldConfig": {
                        "signFieldStyle": 1,
                        "signFieldPosition": {
                            "positionPage": "具体的签署区所在页码",
                            "positionX": 签署区X坐标值,
                            "positionY": 签署区Y坐标值
                        }
                    }
                }
            ]
        }
    ]

指定位置签章--用户页面可移动位置

freeMode 默认：false（非自由签章），可不传；
movableSignField 设置为：true（可移动签署区）；
signFieldStyle 设置为：1（单页签章）；
signFieldPosition 内传入具体的页码，X坐标和Y坐标。

"signers": [
        {
            "signFields": [
                {
                    "normalSignFieldConfig": {
                        "movableSignField": true,
                        "signFieldStyle": 1,
                        "signFieldPosition": {
                            "positionPage": "具体的签署区所在页码",
                            "positionX": 签署区X坐标值,
                            "positionY": 签署区Y坐标值
                        }
                    }
                }
            ]
        }
    ]

自由签章

freeMode 设置为：true（自由签章）；
movableSignField、signFieldStyle、signFieldPosition 均可不传。

"signers": [
        {
            "signFields": [
                {
                    "normalSignFieldConfig": {
                        "freeMode": true
                    }
                }
            ]
        }
    ]

常见场景对接说明

指定位置签章与自由签章