e签宝签署API更新详解：新增signType与FDA合规模式，全面提升签名样式与合规能力

一. 更新速览

e签宝在 2025-09-11 发布的 v3.2.7 版 基于文件发起签署API 中，新增 2 个高频开发者诉求参数：

—
	`signType`		string		否		控制“印章/手写/文字签名”等样式，枚举值扩充至 8 种
	`fdaLanguageMode`		string		否		一键切换 FDA 21 CFR Part 11 合规模式，自动附加时间戳、审计摘要与不可见数字签名

下游无需改造现有业务流，只需在请求 Body 中追加字段即可生效。完整 OpenAPI 文档 已实时同步至：官方链接。

二. 技术细节拆解

1. signType —— 让“签名长什么样”可配置

新增枚举
- OFFICIAL_ROUND_RED：圆角公章（医药注册常用）
- HANDWRITTEN_IPAD：压感笔笔迹（支持 Apple Pencil 压感还原）
- TEXT_SIGNATURE：印刷体文字签名（自动转曲，防二次编辑）
向下兼容旧字段 sealId 仍有效，系统优先以 signType 为准，不存在则回退。

2. fdaLanguageMode —— 21 CFR Part 11 合规“零代码”接入

开启后，e签宝自动完成 3 件事： ① 在 PDF 增量更新区写入符合 PAdES-LTA 标准的不可见数字签名； ② 生成人类可读的审计摘要（Audit Trail），支持英文/简体中文/繁体中文； ③ 时间戳使用 NIST 溯源的 UTC 格式，哈希算法固定为 SHA-256。

调用示例（JSON 片段）

{
"docs": [...],
"signType": "HANDWRITTEN_IPAD",
"fdaLanguageMode": "EN"
}

合规报告获取签署完成后，回调 doneUrl 增加 auditTrails=true 即可一次性拉取 .zip 审计包，含签名证书链、CRL 与 OCSP 响应。

三. 开发者 5 分钟接入指南

1. 升级 SDK

Maven 用户：升级 esign-sdk 至 3.2.7
npm 用户：执行 npm i @esign/js-sdk@latest

2. 灰度测试

在沙箱环境打开 FDA_SANDBOX=true，即可模拟 FDA 时间戳签发，无需消耗正式次数。

3. 签名样式预览

调用 POST /v3/sign/preview，传入 signType 即可返回 72 dpi 的 PNG 缩略图，前端可实时展示给用户确认。

4. 错误码速查

46012 —— 当前企业未开通 FDA 合规模块，需控制台手动开启。
46013 —— signType 与 sealId 同时存在且冲突，需二选一。

四. 典型场景落地


医药研发	临床试验电子知情同意	一键满足 FDA 21 CFR Part 11，海外机构直接认可
跨境电商	供应链采购合同	使用 `TEXT_SIGNATURE` 批量自动签署，1 小时完成 5 万份
工业 IoT	设备维修工单	`HANDWRITTEN_IPAD` 保留技师手写笔迹，防止事后抵赖

五. 性能与配额

单账号默认 QPS=200；开启 fdaLanguageMode 后，因附加时间戳与 OCSP，平均 RT 增加 ≈120 ms，但 QPS 不变。
审计包大小 ≈ 原文件 8%–12%，建议接入 CDN 回源，避免回调接口超时。

六. 下一步规划（官方 Roadmap）

e签宝透露，2025-Q4 将新增：

signType 支持 自定义 SVG 印章上传
API 级别 印章颜色动态替换

届时，开发者无需预置 20 枚不同颜色印章，即可实现 主题色一键切换。

七. 结语

本次更新把 签名样式 与 国际合规 两大痛点打包成 2 个可选参数，开发者无需自建 PAdES 签名与时间戳模块，即可在 1 天内上线符合 FDA 要求 的电子签署链路。

建议医药、跨境电商、出海 SaaS 团队立即在沙箱验证，抢占合规先机。