跳转至主要内容
Certyneo
其他类型的

开发人员的电子签名API

通过REST,可靠的网络连接,Node/Python/Ruby SDK,无限的免费沙盒.

创建一个开发者帐户 应用程序文件

免费沙盒 · 99.95%的上班时间 · 欧盟主权托管

其他应用程序

预测性终点,清洁的JSON,标准HTTP代码.

可靠的网络网络

随数回复,HMAC签名SHA-256,可查询事件日志.

根据本地 eIDAS 规范

通过API旗下可获得AES,AES-Q和QES签名. 包含合格审计路径,欧盟合格TSP证书.

延迟时间 < 200 ms

API托管在欧盟，从欧洲的p95 < 200毫秒。99.95%正常运行时间SLA，实时公开状态。

启动时间5分钟

创建您的第一个封面只需一个HTTP请求.

创建一个信封
curl https://api.certyneo.com/v1/envelopes \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Contrat de prestation",
    "documents": [{"file_url": "https://your.app/contract.pdf"}],
    "recipients": [{"email": "client@example.com", "name": "Jane Doe"}],
    "webhook_url": "https://your.app/webhooks/sign"
  }'

仅需一个POST请求就可以创建一个信封,添加文件,签名和webhook URL.API返回一个可以共享的 sign_url.

官方的Node.js SDK
import Certyneo from '@certyneo/sdk';

const client = new Certyneo({ apiKey: process.env.CERTYNEO_API_KEY });

const envelope = await client.envelopes.create({
  title: 'Contrat de prestation',
  documents: [{ file_url: 'https://your.app/contract.pdf' }],
  recipients: [{ email: 'client@example.com', name: 'Jane Doe' }],
});

console.log(envelope.sign_url); // ready to share with the signer

提供了全方位的键字,自动错误处理,以及流动的包裹构建.

网络网络 实时响应

信封和收件人事件、可验证的HMAC签名和自动提醒。

envelope.completed
{
  "event": "envelope.completed",
  "envelope_id": "env_3a2f...",
  "signed_at": "2026-05-25T14:32:18Z",
  "evidence_url": "https://api.certyneo.com/v1/envelopes/env_3a2f.../audit-trail.pdf",
  "signers": [
    { "email": "client@example.com", "signed": true, "ip": "82.x.x.x" }
  ]
}
  • 每个payload的SHA-256 HMAC签名——在服务器端验证真实性。
  • 临时失败时自动重试：在大约1小时20分钟内进行5次尝试，采用指数退避。
  • 可从仪表板查看的事件日志：查看每次尝试、返回的HTTP状态、请求体。
  • Webhook URL可按信封配置（覆盖）或在项目中全局配置。

为什么需要电子签名专用API？

在您的产品中集成电子签名不是小事。您需要有关法律合规性（eIDAS）、技术可靠性（webhook确实能送达）和数据主权（欧洲服务器以规避云法案）的保证。Certyneo API涵盖这三个方面。

由开发者为开发者设计，遵循现代REST惯例：基于游标的分页、幂等性密钥、URL版本控制、OpenAPI 3.1以自动生成客户端。没有SOAP、没有XML、没有惊喜。

为开发者讲解eIDAS合规性

eIDAS法规定义了三个签名级别：简单（SES）、高级（AES）和合格（QES）。Certyneo API允许通过`signature_level`字段按信封选择级别。默认值为AES（对95%的B2B情况足够）。QES可用于需要与手写签名严格法律等效的行为（公证行为、公共采购）。

技术上，AES要求对签署人进行强认证（默认通过短信OTP，可选视频KYC）和带时间戳的审计跟踪。QES增加由合格欧盟TSP签发的合格证书。这一切都由API管理——您调用端点，我们处理其余部分。

推荐的集成架构

最常见的集成模式遵循以下流程：

  • 您的后端调用POST /v1/envelopes创建信封，并接收一个sign_url呈现给用户。
  • 您将用户重定向到sign_url或在iframe中嵌入（通过Pro计划使用您的品牌）。
  • 签名完成后，Certyneo使用envelope.completed事件调用您的webhook。
  • 您更新数据库并通知用户（电子邮件、应用内通知等）。

无限制免费沙箱

沙箱环境免费且无限制。所有生产功能都可用，除了签名没有法律价值（PDF标记为SANDBOX）。适合自动化测试、客户演示、本地开发。沙箱密钥与生产密钥不同，两者之间完全隔离。

如果您不想编写代码

该API的所有功能也可以不编写任何代码通过工作流进行控制：创建信封、发送信封、响应签名、获取密封的PDF及其审计跟踪。相同的基础设施，使用可视化设计器替代HTTP客户端。查看 Power Automate和Microsoft 365集成.

从DocuSign或Yousign迁移

如果您已有DocuSign或Yousign集成，API映射是直接的：envelopes → envelopes、recipients → recipients、status webhooks → status webhooks。我们的迁移指南逐个端点记录等效性。完整迁移需要1-3天，如果您使用内部包装器会更快。

您正在从Adobe Acrobat Sign（原名EchoSign，后为Adobe Sign）迁移？映射同样直接——agreements → envelopes、participants → recipients、webhooks → webhooks。 比较 Certyneo 和 Adobe Acrobat Sign →

电子签名 API 的价格：在哪里购买订阅？

购买签名API订阅不需要报价单或订购单：沙箱免费且无限制，API密钥从仪表板生成，生产REST API访问从标准计划（19€/月）开始包含——包括webhooks和SDK，每个签名无费用。

  • 标准版——19€/月：100个信封/月、REST API + webhooks、10个用户
  • 商业版——39€/月：300个信封/月、批量发送、网页表单
  • 商业专业版——99€/月：1000个信封/月、高频API（300次请求/分钟）、无限用户

合格签名(QES)是一个独立产品，按笔次计费：每个签名14.90欧元，适用于所有套餐，包括免费套餐。

对于大容量或需要合同保证（SLA、专用 DPA、年度计费）的情况，企业计划需要向销售团队订购。在所有情况下，价格都是公开的——在您做出承诺之前进行比较。

常见问题——API

API的速率限制是多少？

默认每分钟1000个请求，可根据高用量需求增加（工厂、多租户平台）。每个响应上的X-RateLimit-Remaining标头显示剩余配额。超出时，API返回429和Retry-After。

API成本是多少？

沙箱（密钥sk_test_）免费且无限制。生产REST API访问从标准计划19€/月开始包含（100个信封/月），然后是商业版39€/月和商业专业版99€/月，配额逐级提升；合格电子签名（QES）是独立产品，按次数计费14.90€每个签名。对于更大的业务量或加强的SLA，企业计划通过销售团队订购。

有SLA吗？

商业和企业计划99.95%正常运行时间（每年最多4小时停机）。具有事件历史的公共状态页面：status.certyneo.com。企业计划在未达到SLA时包括自动积分。

您使用什么身份验证？

Bearer令牌（API密钥）在Authorization标头中。密钥可从仪表板轮换，具有立即撤销功能。对于OAuth集成（多租户平台），我们在企业计划上提供OAuth 2.0客户端凭证。

如何验证webhook的HMAC签名？

每个webhook包含X-Certyneo-Signature标头，包含payload的HMAC SHA-256，用您的webhook密钥签名。在服务器端，重新计算HMAC并以恒定时间比较（时间安全比较）。官方SDK通过webhook.verify(payload, signature, secret)自动完成此操作。

SDK是开源的吗？

是的。Node、Python和Ruby SDK在GitHub上以MIT许可证提供。您可以fork、贡献或简单地审计。二进制文件在npm、PyPI和RubyGems上以@certyneo / certyneo命名空间发布。

我可以不注册就测试吗？

可以，通过API文档的交互式示例：/developers/playground。请求在共享沙箱实例上运行，无需密钥。对于认真使用，请创建免费开发者账户（无限沙箱）。

EchoSign API（现为Adobe Acrobat Sign）要多少钱？

EchoSign于2011年被Adobe收购，更名为Adobe Sign随后为Adobe Acrobat Sign：API仍然存在，但其价格不公开，需通过Adobe销售团队的企业报价，通常按年度交易额分层收费。相反，Certyneo公开其价格：生产API访问从标准计划19€/月开始包含，可在线订购无需报价，沙箱免费无限制用于评估API再付款。

准备集成电子签名了吗？

无限制免费沙箱、完整文档、官方SDK。立即开始。

阅读文档 与Certyneo开发者交流