开放签API快速入门指南

目的

企业版 API 接口旨在实现与各类业务系统的深度集成，包括 ERP、CRM、HRM 及 OA 等系统，实现 PC 端和移动端无缝对接开放签电子签章系统，保障企业业务流程高效协同。

---

对接集成说明

通过简单集成，业务系统可快速接入开放签电子签章平台，获得电子文件签署能力，核心流程如下：

---

API 接口相关参考文档

• 接入流程: 详细介绍开放签 API 的接入流程，包括开发者注册、企业认证、印章与模板配置、业务线设置及签署流程示例，帮助开发者高效集成电子合同签署能力。
• 接口总体说明: 整体介绍接口调用的通信方式、公共参数、签名验签。
• 异步通知服务: 对开放签端异步通知服务进行说明。
• 全局返回码表: 接口对应的全局返回码表，帮助开发者快速识别错误原因。
• 签署位置计算说明: 对签署位置计算逻辑进行说明，包括 坐标位置计算 和 关键字位置计算 。

API 接口清单

接口名称	接口描述
上传签约文件	1、此接口是将签约文件保存到开放签系统，在 发起签署 接口中使用。 2、仅支持 .pdf 格式，文件不超过30MB；
上传合同附件	1、此接口是将附件保存到开放签系统，在 发起签署 接口中接口中用于添加合同附件。 2、支持 .doc, .docx, .wps, .jpg, .png, .pdf, .xls, .xlsx, .zip, .rar 格式，附件不超过20MB；
发起签署	根据业务线的预设配置以及接口的传参，直接发起合同签署流程
获取合同短链接	查询合同短链接,用户打开链接查看合同详情或进行合同内容的完善、签署
获取合同待办任务	查询合同的状态以及待办任务
下载签约文件	下载签约文件，多用于签署完成后，业务系统下载该文件进行归档
签署个人签名	签署人已经将个人签名授权给了对接方企业以及对应业务线，且授权有效时，可调用此接口完成个人签名的自动签署。
获取业务线列表	根据办理人账号查询当前办理人在该企业下可发起的业务线列表
个人实名认证数据推送	完成个人账号注册及实名信息推送，在实名认证时，将实名数据预填充到实名认证页面，减少用户输入操作，提升实名认证效率
企业实名认证数据推送	完成企业账号的注册和实名信息推送，在实名认证时，将实名数据预填充到实名认证页面，减少用户输入操作，提升实名认证效率