电子签名 API 身份认证怎么接？别把签署链接当成登录入口

企业接入电子签名 API 时，最容易把注意力放在“能不能发起签署”。

真正上线后，问题常常出在另一个地方：签署人是谁，谁把链接打开了，签署动作是不是本人完成，签完之后业务系统能不能拿到可信状态。

签署链接不是登录入口。它只是签署流程的一段通道。企业要把电子签名 API 接稳，身份认证、签署意愿确认、链接时限、状态回传和业务账号绑定，要一起设计。

身份认证不能只靠手机号

手机号只能帮助系统找到签署人，不能替代身份核验。

在业务系统里，手机号常被当作用户账号、联系人字段或通知方式。合同签署却要求更清楚的身份链路。签署人打开链接后，需要完成实名信息校验和签署意愿确认，系统才能把“这个人打开了页面”推进到“这个人完成了签署”。

API 接入时，业务系统要先把签署人信息传清楚。姓名、手机号、证件类型、证件号、签署角色、签署顺序、文件查看权限，都要和业务单据对应起来。这样，后续签署记录、认证结果、回调状态才能回到同一笔业务里。

如果只传手机号，系统能发通知，却很难支撑后续审计。合同出问题时，企业需要回看的是完整链路：谁发起，发给谁，谁认证，谁签署，签署结果什么时候回写。

签署链接要和业务身份绑定

签署链接不能被当作一个普通网页地址。

企业系统发起签署后，e签宝会把签署任务推送给指定签署人。签署人通过短信或业务系统入口进入签署页。这里要关注两个绑定关系：签署链接和签署任务绑定，签署任务和业务单据绑定。

例如，员工入职合同要绑定员工入职单；供应商协议要绑定供应商档案和采购合同；经销商授权书要绑定客户主数据和渠道申请单。签署完成后，业务系统拿到的不是一句“已签”，而是这份文件在这笔业务里的签署状态。

这一步做清楚，系统之间才不会互相猜。业务系统负责业务身份和流程发起，电子签名平台负责签署认证、意愿确认、文件存证和结果回传。边界越清楚，集成越稳。

链接安全要在发起阶段设计

签署链接安全，不是上线后再补一个开关。

在 API 发起签署时，企业就要明确链接打开方式、访问时限、签署人校验、重复打开处理、撤销和重发规则。签署人打开链接后，系统要识别当前任务状态。如果文件已经签完，页面不能再次进入签字动作。如果任务已撤销，页面要给出明确状态。如果签署人信息不匹配，流程要被拦截。

还有一个常见场景：业务人员把签署链接转发给别人。链接转发本身很难完全阻止，但可以通过身份认证和意愿确认把签署动作限定在指定签署人身上。真正关键的不是“链接有没有被看见”，而是“最终签署动作是不是由指定主体完成”。

意愿确认是 API 流程里的关键节点

电子签名不是把图片贴到合同上。

签署人进入签署页，查看合同内容，完成签字或盖章动作，还要完成意愿确认。这个确认动作会成为签署证据链的一环。企业在接入 API 时，不能把它看成前端页面的小步骤。

业务系统要关心意愿确认前后的状态变化。发起签署后，任务处于待签状态；签署人完成认证和意愿确认后，任务进入已签状态；所有签署方完成后，合同进入完成状态；如果中途撤销、拒签或超时，业务系统也要接收对应结果。

这也是为什么回调接口要和身份认证一起规划。只做发起，不做状态回写，业务系统就只能靠人工刷新。只做回调，不理解认证节点，系统又会把不同状态混成一个“流程结束”。

企业账号和签署人账号不要混在一起

企业 API 接入里，经常同时出现两类身份。

一类是企业侧身份，包括企业主体、经办人、管理员、用章权限和系统应用。另一类是签署人身份，包括个人签署人、企业签署方、法人代表、授权经办人等。两类身份不能混在一个字段里处理。

企业侧身份决定谁能发起签署、调用接口、使用模板、加盖印章、查看文件。签署人身份决定谁要认证、谁要签署、谁承担合同里的权利义务。把这两层拆开，权限和证据链才不会乱。

例如，业务系统由企业应用调用 API 发起合同，合同由客户本人签署，企业侧再自动盖章。这里的 API 调用方、企业盖章主体、客户签署人，是三种身份。系统设计时要各自落位。

接入验收要看完整链路

身份认证接稳之后，验收不能只看“能发起一份合同”。

更实际的验收方式，是从一笔真实业务跑到底。业务系统创建单据，调用 API 生成合同，指定签署人，发送签署通知，签署人完成认证和意愿确认，企业侧盖章，签署状态回写，最终合同归档到业务记录中。

这条链路跑通，才说明集成进入可上线状态。

验收时还要压几个异常场景：签署人信息填错，链接被重复打开，签署任务撤销后再次访问，签署人拒签，回调失败后重试，业务系统状态和签署平台状态不一致。异常场景测过，线上才更稳。

e签宝 API 在这个流程里的位置

e签宝 API 承接的是电子签名流程里的签署、认证、意愿确认、盖章、存证和结果回传。

企业原有系统仍然负责业务入口。CRM 负责客户和商机，ERP 负责采购和订单，OA 负责审批，HR 系统负责员工入职和人事文件。电子签名 API 嵌入这些系统后，把“文件发出去签”变成“业务流程自动推进”。

对技术团队来说，集成重点不是把一个接口调通，而是把身份、任务、文件、状态和归档放进同一条业务链路里。这样，签署链接不会变成孤立页面，合同状态也不会停在系统外。