签盾开放平台-电子签约服务
  1. 合同相关
签盾开放平台-电子签约服务
  • 接入流程介绍
  • 应用创建流程
  • 前端接入文档
  • 开发前必读
    • 常用接口清单和关键流程
    • 公共请求格式
  • 帮助文档
    • 印章指定位置
    • 静默签使用说明
  • 实名认证
    • 个人认证
      • 个人认证项
        • 个人身份二要素核验
        • 个人运营商三要素核验
        • 个人人脸核验(H5适配)
        • 个人人脸核验查询
        • 发送短信验证码
        • 校验短信验证码
        • 个人银行卡四要素核验
      • 个人实名认证地址(页面)
    • 企业认证
      • 企业认证项
        • 企业四要素核验
        • 企业三要素核验
        • 发起打款认证(正向打款)
        • 验证打款金额(正向打款)
        • 查询打款进度(正向打款)
        • 企业经办人授权书认证-上传
        • 企业经办人授权书认证-查询
        • 查询打款银行信息
      • 企业实名认证地址(页面)
    • 查询认证信息
      GET
  • 用户管理
    • 个人用户
      • 修改个人用户
      • 创建已认证个人用户
      • 查询个人用户信息
    • 企业用户
      • 查询企业用户信息
      • 创建已认证企业用户
    • 创建未认证用户(暂不支持企业)
      POST
    • 创建未认证用户
      POST
  • 文件相关
    • 上传文件
      POST
    • 基于模板生成文件
      POST
    • 获取拖章定位
      GET
    • 获取拖章定位页面
      POST
  • 合同相关
    • 通过文件发起合同
      POST
    • 查询签署方信息
      GET
    • 下载合同文件及附件
      GET
    • 合同查询
      GET
    • 获取合同签署链接(页面)
      POST
    • 无感签署(申请开放)
      POST
  • 印章管理
    • 查询印章列表
    • 查询印章详情
    • 印章静默签授权地址(H5页面)
  • 接口回调
    • 回调接入文档
    • 获取回调信息
    • 回调成功确认
  • 开放接口
    • 短信验证码
    • 通知短信发送
    • 身份证OCR
    • 营业执照OCR
    • 银行卡OCR
  1. 合同相关

无感签署(申请开放)

POST
/open/contract/insensibleSign
签署人对发起后的合同进行签署。相较于普通签署方式,此接口无需进行意愿认证(即用户无感知)
注意
1.
无感签需申请后才开放
2.
通过查询签署方信息接口,可获取合同签署方信息
3.
一次签署任务所用印章必须属于同一个签署人
4.
每次签署会导致合同fileCode变化,如使用fileCode调用签署,具体fileCode信息请通过提示2的方式获取
5.
签署坐标相关详见印章指定位置
6.
若此业务场景不满足,签署场景需要签署人相对无感,且需要签署人授权,则可以使用静默签,若需要使用静默签,详见静默签使用说明
可能出现的错误码
错误码错误信息解决办法
500服务繁忙,请重试.联系客服
400参数错误.参数与接口文档进行核对
oc_10011用户未认证用户认证
oc_20006无效印章检查印章信息
oc_20007印章信息解析失败检查印章信息或联系客服
oc_40005签署记录不存在或状态异常检查签署人状态
oc_40006合同不存在或状态异常检查合同状态
oc_40007合同正在签署中,请稍后重试稍后重试
oc_40008时间戳证书签发失败联系客服
oc_40011文件签署失败联系客服
oc_40013合同签署已截止检查合同信息
oc_40015未找到关联签署文件参数检查
oc_40016签署位置不能重复参数检查
oc_40017签署区域与设置签署区域不同参数检查
oc_40020单页合同文件不能进行骑缝签章参数检查
oc_40021应用未开启无感签,请联系签盾管理员开启联系客服
oc_40029意愿认证方式错误重新进行意愿认证

请求参数

Body 参数application/json

示例
{
    "contractId": "1867386328003383296",
    "signFields": [
        {
            "fileCode": "FC_20241212171254RkztvLleUICgRSe",
            "sealId": 100000007,
            "dateFormat": "YYYY年MM月DD日",
            "signFieldStyle": 1,
            "signFieldPosition": {
                "positionPage": 1,
                "positionX": 200,
                "positionY": 400
            }
        },
        {
            "fileCode": "FC_20241212171254RkztuileUICgRPd",
            "sealId": 100000008,
            "dateFormat": "YYYY-MM-DD",
            "signFieldStyle": 2,
            "signFieldPosition": {
                "positionPage": 0,
                "positionX": 0,
                "positionY": 300
            }
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'api.pre-qiandun365.com/api/open/contract/insensibleSign' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contractId": "1867386328003383296",
    "signFields": [
        {
            "fileCode": "FC_20241212171254RkztvLleUICgRSe",
            "sealId": 100000007,
            "dateFormat": "YYYY年MM月DD日",
            "signFieldStyle": 1,
            "signFieldPosition": {
                "positionPage": 1,
                "positionX": 200,
                "positionY": 400
            }
        },
        {
            "fileCode": "FC_20241212171254RkztuileUICgRPd",
            "sealId": 100000008,
            "dateFormat": "YYYY-MM-DD",
            "signFieldStyle": 2,
            "signFieldPosition": {
                "positionPage": 0,
                "positionX": 0,
                "positionY": 300
            }
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "string",
    "msg": "string",
    "result": {
        "contractId": 0,
        "businessCode": "string"
    },
    "success": true,
    "logKey": "string",
    "ts": 0
}
修改于 2025-05-15 01:47:11
上一页
获取合同签署链接(页面)
下一页
查询印章列表
Built with