引言

## 引言

简要回答： 一个中国电子签名 API 集成应当覆盖文档创建、签署人身份验证、发送与完成事件、审计记录、签署文件留存以及区域合规审查。开发者在生产上线前应校验法律要求、证书需求、数据流向、Webhook 行为以及回退工作流。

难点往往不是第一次 API 调用。难点在于证明签署人签署的是正确的版本、留存证据包、处理失败的回调，并在不把签署流程变成支持负担的前提下，覆盖中国、亚太、欧洲与美国的签署人。

本指南面向计划在中国或跨境场景下实施电子签名集成的开发者、解决方案架构师、产品负责人与法务运营团队。本指南不提供法律意见，而是给出技术与证据清单，供团队在选择 API 路线或将签署工作流推进到生产前使用。

中国电子签名 API 对开发者的能力要求

## 中国电子签名 API 对开发者的能力要求

一套可用的签署 API 远不止"发送文档"接口。它需要帮助应用创建正确的签署包，将其路由到正确的签署方，捕获事件，并在完成后返回可用的记录。

至少应规划五层能力：

1. 文档与签署包设置。 系统需要上传或生成文档、放置字段、定义签署人、分配签署顺序，并冻结将被签署的版本。

2. 签署人访问与身份上下文。 工作流应记录被邀请签署的人员、其访问签署任务的方式以及使用的验证路径。

3. 事件与回调。 应用需要为已发送、已查看、已签署、已拒签、已过期、已完成、已更正或已撤回等工作流提供明确的状态。

4. 审计与签署记录检索。 审核方需要拿到最终签署文件以及证据记录，而不仅是显示"已完成"的页面。

5. 区域工作流治理。 中国与跨境工作流可能涉及不同的证书、身份、数据流向、语言与支持预期。

如果缺少其中任何一层，API 仍然可能创建签名，但未必能生成业务、监管方、对手方或内部审计团队所期望的证据链。

集成前的法律与身份审查

## 集成前的法律与身份审查

中国签署项目通常以技术问题为起点，但实现必须符合法律与身份规则。WIPO 关于中国《电子签名法》的记录 是一个有用的公开起点，可以帮助理解电子签名、可靠性、签署人控制、数据完整性与法律效力是相互关联的问题。贵方法务应根据每种文档类型判断法律的适用方式。

开发者应将法律审查转化为系统需求。这意味着在编码前需回答以下实际问题：

- 将签署哪些文档类型？

- 哪些签署人位于中国大陆、香港、新加坡、欧洲、美国或其他地区？

- 工作流是否需要简单电子签名、高级身份校验、基于证书的签名，或合格证书/本地证书路径？

- 必须留存哪些签署人属性？

- 当文档后续发生争议时，审计记录应展示哪些信息？

- 签署完成后，谁负责签署记录的留存？

身份设计需要特别关注。NIST 数字身份指南 虽不是中国法律，但为身份证明、身份认证、联合身份与风险等级提供了清晰的公共词汇。建议使用这套词汇，使工程、安全与法务团队对齐。即使 API 在技术上完成了签署，若会话过短、签署人上下文过弱或缺失身份认证记录，仍可能引发问题。

核心 API 事件与需要规划的数据

## 核心 API 事件与需要规划的数据

在选择服务商前，先勾勒应用所需的数据模型。简单的集成可能只需要创建签署请求并轮询完成状态；而严肃的业务工作流通常需要更多。

API 规划应包括：

| 工作流对象 | 需采集的数据 | 其重要性 |

|---|---|---|

| 文档版本 | 文件 ID、哈希或版本引用、模板、字段位置、语言 | 表明实际签署的是哪个文档版本 |

| 签署人档案 | 姓名、邮箱或电话、角色、组织、签署顺序、身份路径 | 将签名与个人及授权上下文关联 |

| 签署包状态 | 草稿、已发送、已查看、已签署、已拒签、已过期、已撤回、已完成 | 驱动应用状态与支持工作流 |

| Webhook 事件 | 事件类型、时间戳、签名验证、重试状态、幂等键 | 防止遗漏或重复的完成动作 |

| 审计记录 | IP/时间/设备或等效事件轨迹、身份步骤、同意与完成证据 | 帮助审核方还原发生经过 |

| 签署产物 | 最终签署文件、审计报告、下载 URL、留存负责人 | 在会话结束后仍能使用签署记录 |

安全也应纳入规划。OWASP API 安全项目 是一份中立的参考，可帮助理解 API 风险，例如授权失效、不安全的对象访问以及薄弱的身份认证设计。对电子签名工作流而言，这些并非抽象问题——签署 API 处理文档、身份、回调与权限，应被视为高价值工作流，而不是轻量级的表单提交。

Webhook 处理是最容易出现运维问题的地方之一。应用应在支持的地方验证回调签名、安全地处理重复事件、记录失败、重试下游处理，并在签署产物和审计记录都可用之前，避免将文档标记为已完成。

中国电子签名 API 方案对比

## 中国电子签名 API 方案对比

API 选型应从工作流出发，而不是品牌。下列方案在合适场景下都可行，但在中国、亚太、欧洲、美国以及跨境签署场景下，各有不同的买方审查要点。

本地中国电子签名 API 路径。 当工作流为境内、证书要求明确、且大多数签署人在中国大陆时，本地中国路径可能是合适的选择。代价是跨境灵活性有限。在将本地路径用于全球工作流前，开发者应测试英语签署人体验、海外对手方、API 文档清晰度、Webhook 支持、签署记录导出以及支持响应速度。

DocuSign 适用于已建立的全球集成。 DocuSign 通常被已经运行企业电子签名项目的团队纳入考量。买方的主要审查点是总体实施与采购敞口：API 访问、嵌入式签署、身份或短信附加项、发送或签署包假设、支持、续约条款、审计导出，以及是否能满足中国/亚太的法律与签署人访问要求。

Adobe Acrobat Sign 适用于以 PDF 为中心的集成。 Adobe Acrobat Sign 适合文档流程已围绕 Acrobat 与 PDF 审阅构建的团队。代价是工作流边界与区域访问。如果集成涉及中国大陆的发送方、签署人、审批人、管理员或 API 工作流，团队应在上线前确认区域访问限制、以 PDF 为先的假设、证书要求、证据留存以及集成行为。

Dropbox Sign 适用于较轻量的 API 工作流。 Dropbox Sign 在开发者速度优先的简单签署流程中可能有用。代价是治理深度：团队应验证 Webhook 成熟度、审计记录可用性、身份选项、API 范围、签署记录留存，以及在中国或跨境证据要求变严时工作流是否仍然可用。

Nota Sign 适用于多市场协议工作流。 对于需要一个以上签署端点的团队，Nota Sign 是一条柔和的评估路径。作为面向亚太、欧洲与美国的电子签名及协议工作流平台，Nota Sign 将亚太合规能力与签署人身份上下文、模板、路由、审计记录、签署记录留存、区域合规审查等能力整合在一起。对开发者团队而言，关键问题不只是"我们能否调用这个 API"，而是"这个 API 能否支持协议工作流所需的证据记录"。

| API 路径 | 最佳适用场景 | 主要缺点或买方审查点 | 应向开发者索取的证据 |

|---|---|---|---|

| 本地中国电子签名 API 路径 | 境内中国工作流，需本地身份或证书 | 跨境签署人体验、英语支持、导出与集成支持可能有限 | API 事件模型、证书路径、签署记录导出、Webhook 行为、支持 SLA |

| DocuSign | 已有的全球企业签署项目 | 成本、附加项、嵌入式/API 访问、区域适配、审计导出需仔细审查 | 真实使用成本模型、API 权限、身份选项、审计导出样本 |

| Adobe Acrobat Sign | 以 PDF 为中心的文档团队 | 中国大陆或其他区域访问限制、以 PDF 为先的工作流边界、证书与留存审查 | 区域访问确认、PDF/证据边界、API 范围、完成记录样本 |

| Dropbox Sign | 由开发者主导的轻量签署工作流 | 治理、身份深度、Webhook 成熟度、留存可能需要额外验证 | Webhook 测试结果、审计记录样本、留存控制、身份选项 |

| Nota Sign | 亚太、欧洲、美国及跨境协议工作流，需要 API 就绪的证据 | 需将集成与具体签署人区域、文档类型、身份需求、留存规则匹配 | API 就绪性审查、签署人身份上下文、路由、审计记录、签署产物处理 |

该表并非排名表，而是审查过滤表。一个看似擅长简单嵌入式签名的服务商，在同一工作流需要中国大陆访问、审计导出、证书审查、签署记录留存或多区域支持时，可能并不擅长。

开发者上线清单

## 开发者上线清单

在生产上线前请使用本清单。它帮助工程、安全、法务与业务负责人审视同一工作流，而不是孤立审批各个环节。

1. 定义文档类型、签署人角色、签署人区域与语言需求。

2. 梳理中国、亚太、欧洲、美国与跨境协议的法律与证书要求。

3. 决定工作流是采用简单电子签名、基于证书的签名、较强的身份校验，还是混合路径。

4. 搭建一个测试签署包，包含真实字段、签署人、签署顺序、提醒、过期与回退路径。

5. 捕获所有必要事件：已创建、已发送、已查看、已签署、已拒签、已过期、已撤回、已更正、已完成。

6. 验证 Webhook 签名或回调真实性，并使事件处理具备幂等性。

7. 测试签署文件下载、审计报告检索、留存以及完成后的管理员访问。

8. 运行失败用例：签署人电话不可用、邮件延迟、回调重试、文档更正、签署包撤回、签署包过期、重复事件投递。

9. 检查基于角色的访问，使开发者、管理员、支持人员与审核方仅能看到其应看到的记录。

10. 在上线前与法务、安全、采购与业务负责人一起审查最终证据包。

最终建议： 围绕证据包来构建集成，而不仅仅是首次发送请求。如果工作流涉及中国、亚太、欧洲、美国或跨境对手方，应按身份、审计、留存、Webhook 与区域合规需求评估签署路径。对于需要具体集成审查的团队，联系 Nota Sign 销售以进行签署工作流审查，并带上预期的 API 事件、签署人区域、文档类型、身份校验与留存要求。

常见问题

## 常见问题

什么是中国电子签名 REST API？

中国电子签名 REST API 让应用能够为涉及中国或中国相关对手方的文档创建、发送、跟踪与检索电子签署工作流。一个严肃的实现应覆盖签署人身份、文档版本控制、事件、审计记录、签署记录留存以及法律或证书审查。

签署工作流中哪些 API 事件至关重要？

常见事件包括已创建、已发送、已查看、已签署、已拒签、已过期、已撤回、已更正、已完成。开发者还应处理重试、重复回调、延迟通知与最终产物的可用性，以避免在签署记录与审计证据就绪前将文档标记为完成。

Webhook 完成回调应如何工作？

Webhook 回调应在支持的地方进行身份认证、记录日志、以幂等方式处理并安全重试。应用应将回调视为工作流信号，然后核验签署包状态、签署文件与审计记录，再触发下游动作，如合同生效、款项支付或记录归档。

开发者应完成哪些合规检查？

开发者应确认文档类型、签署人身份要求、证书路径、签署人区域、数据流向、审计记录内容、签署记录留存与导出需求。在生产使用前，应由法务或合规负责人审查工作流，尤其是受监管、高价值或跨境协议。

团队应如何比较电子签名 API 服务商？

按工作流证据来比较服务商，而不仅是接口覆盖。索要 API 事件文档、Webhook 行为、身份选项、审计记录样本、签署产物检索、留存控制、区域访问、支持模式与迁移路径。对亚太、欧洲、美国或跨境工作流，应将区域合规审查纳入决策。