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 团队立即在沙箱验证,抢占合规先机。
推荐阅读
最新文章
- 2026大学生寒假兼职新风口:从送外卖到做AI副业,你还在靠体力赚零花钱吗?
- 如何获取Microsoft API Key 密钥实现bing搜索分步指南
- Google Pay UPI 注册与集成指南
- 香港支付宝可以绑定大陆银行卡吗?详解使用方法与步骤
- New API架构:探索现代软件开发的新趋势
- 什么是 Wandb
- 在 Golang 中实现 JWT 令牌认证
- 如何使用 Google News API 获取实时新闻数据
- Google DeepMind发布 Genie 3与Shopify:2小时上线电商3D样板间实战
- FLUX.1 Kontext API 使用完全指南:解锁文本驱动的智能图像编辑
- 如何防范User-Agent信息伪装引发的API访问风险
- 苹果支付流程:从零开始的接入指南