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

开发人员的电子签名API

将符合 eIDAS 的电子签名集成到您的应用中：REST API、HMAC 签名的 Webhook、通过 iframe 嵌入式签署，免费版账户即可获得免费测试密钥。

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

免费测试密钥 · SLA 99.9 %（Business 和 Enterprise） · 欧盟境内托管

REST + OpenAPI 规范

可预期的端点、整洁的 JSON、标准 HTTP 状态码。可下载 OpenAPI 规范，自行生成客户端。

可靠的网络网络

间隔递增的 5 次重试、HMAC SHA-256 签名，失败的事件可在仪表板中重新投递。无需自行编写轮询代码。

根据本地 eIDAS 规范

简单签名、高级签名（短信 OTP）和合格签名，每个信封通过 signatureLevel 字段选择。每份已签署文档均附带带时间戳的审计追踪。

托管于欧盟境内

服务器位于德国、法国和西班牙。按套餐公开速率限制，每个响应都带有 X-RateLimit 标头。Business 和 Enterprise 提供 99.9 % 的 SLA。

三次调用即可上手

上传 PDF、创建信封、发送信封：三个 HTTP 请求就够了。

cURL — 上传、创建、发送
# 1. Upload the PDF
curl https://certyneo.com/api/v1/documents \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -F "file=@contrat.pdf"
# → { "id": "cm8doc...", "status": "READY", ... }

# 2. Create the envelope (draft)
curl https://certyneo.com/api/v1/envelopes \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Contrat de prestation",
    "documentIds": ["cm8doc..."],
    "recipients": [{ "email": "client@example.com", "name": "Jane Doe" }]
  }'
# → { "id": "cm8env...", "status": "DRAFT", ... }

# 3. Send the invitations
curl -X POST https://certyneo.com/api/v1/envelopes/cm8env.../send \
  -H "Authorization: Bearer $CERTYNEO_API_KEY"

POST /documents 返回 PDF 的标识符，POST /envelopes 创建包含签署人的草稿，随后 POST /envelopes/:id/send 发送邀请。之后的进度通过 Webhook 推送。

Node.js — 原生 fetch，零依赖
// Node 18+ — native fetch, no dependency
import { readFile } from "node:fs/promises";

const API = "https://certyneo.com/api/v1";
const auth = { Authorization: `Bearer ${process.env.CERTYNEO_API_KEY}` };

// 1. Upload the PDF
const form = new FormData();
const pdf = new Blob([await readFile("contrat.pdf")], { type: "application/pdf" });
form.append("file", pdf, "contrat.pdf");
const doc = await (await fetch(`${API}/documents`, { method: "POST", headers: auth, body: form })).json();

// 2. Create the envelope (draft)
const envelope = await (await fetch(`${API}/envelopes`, {
  method: "POST",
  headers: { ...auth, "Content-Type": "application/json" },
  body: JSON.stringify({
    subject: "Contrat de prestation",
    documentIds: [doc.id],
    recipients: [{ email: "client@example.com", name: "Jane Doe" }],
  }),
})).json();

// 3. Send the invitations
await fetch(`${API}/envelopes/${envelope.id}/send`, { method: "POST", headers: auth });

无需任何 SDK：可使用 Node 18 的原生 fetch 或任意 HTTP 客户端调用 API。还可以根据 OpenAPI 规范，用您的编程语言生成带类型的客户端。

网络网络 实时响应

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

envelope.completed
{
  "id": "cm8f2h6a10004qr9k5p2wm3xt",
  "event": "envelope.completed",
  "data": {
    "envelopeId": "cm7x2k9p40001qz8h3f7bn2ld",
    "subject": "Contrat de prestation",
    "status": "COMPLETED",
    "completedAt": "2026-09-26T08:42:13.000Z",
    "recipientCount": 1,
    "recipients": [
      { "email": "client@example.com", "name": "Jane Doe", "role": "SIGNER", "status": "SIGNED" }
    ],
    "signedDocumentUrl": "https://storage.certyneo.com/signed/...pdf?X-Amz-Expires=604800&..."
  },
  "timestamp": "2026-09-26T08:42:13.521Z"
}
  • 每个payload的SHA-256 HMAC签名——在服务器端验证真实性。
  • 临时失败时自动重试：在大约1小时20分钟内进行5次尝试，采用指数退避。
  • 失败的事件会列在仪表板中，一键即可重新投递。连续失败 5 次后，该端点将被暂停，并通知您。
  • Standard 最多 5 个端点，Business 最多 15 个，Business Pro 最多 50 个，每个端点均可订阅您选择的事件。

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

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

由开发者设计、为开发者打造，遵循 REST 惯例：URL 中带版本号（/api/v1），通过 page 和 limit 分页，JSON 错误附带机器可读的错误码，并提供用于生成客户端的 OpenAPI 规范。没有 SOAP，没有 XML，没有意外。

为开发者讲解eIDAS合规性

eIDAS 法规定义了三个签名级别：简单（SES）、高级（AES）和合格（QES）。Certyneo 的 API 可通过 signatureLevel 字段为每个信封选择级别：SIMPLE（默认）、ADVANCED 或 QUALIFIED。简单签名足以覆盖大多数常见商业合同；当法律条文或收件人要求与手写签名等效时，则使用 QES。

技术层面，高级级别会自动启用短信 OTP，并要求每位签署人提供手机号码。审计追踪按照 RFC 3161 标准加盖时间戳。QES 基于欧盟合格信任服务提供商签发的合格证书。一切均可通过 API 控制。

推荐的集成架构

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

  • 您的后端上传 PDF（POST /api/v1/documents），以草稿形式创建信封（POST /api/v1/envelopes），然后发送（POST /api/v1/envelopes/:id/send）。
  • 签署人通过电子邮件收到邀请，或借助 iframe 嵌入式签署直接在您的界面中签署（POST /api/v1/envelopes/:id/embed-url，Standard 套餐起可用）。
  • 签名完成后，Certyneo使用envelope.completed事件调用您的webhook。
  • 您更新数据库并通知用户（电子邮件、应用内通知等）。

免费测试密钥

所有套餐（包括免费版）均可使用 sk_test_ 密钥，测试信封不占用您的月度配额。在免费版中，测试信封只能发送到您自己的电子邮箱，且限制为每小时 20 个请求；付费套餐为每小时 200 至 1000 个请求。测试数据在 30 天后删除。此外，免费版账户创建的第一个测试密钥还会赠送一个月的 Standard 套餐。

如果您不想编写代码

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

从DocuSign或Yousign迁移

如果您已经集成了 DocuSign 或 Yousign，术语非常接近：envelopes → envelopes、recipients → recipients、状态 Webhook → webhooks。从 DocuSign 和 Yousign 迁移到 Certyneo 的迁移指南详细介绍了从导出模板到切换 Webhook 的各个步骤。

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

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

购买签名 API 订阅无需报价单或采购订单：测试密钥免费，API 密钥可在仪表板中生成，生产环境 REST API 访问权限从 19 €/月的 Standard 套餐起即已包含——含 Webhook，简单签名不按次收费。

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

合格签名（QES）按次计费，在发送时支付：有订阅时，在用完 Business 和 Business Pro 所含的 QES 后，每次签名 9.90 €，从已绑定的银行卡扣款；无订阅时为 14.90 €。

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

进一步了解

常见问题——API

API的速率限制是多少？

限制按每个密钥、每分钟计算，取决于套餐：Standard 为 60 个请求，Business 为 120 个，Business Pro 为 300 个，Enterprise 为 1000 个。每个响应都带有 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 标头；超出后，API 返回 429 并附带 Retry-After 标头。

API成本是多少？

测试密钥（sk_test_）在所有套餐中均免费。生产环境 REST API 访问权限从 19 €/月的 Standard 套餐（100 个信封/月）起即已包含，其后是 39 €/月的 Business 和 99 €/月的 Business Pro，配额逐级提升；合格签名（QES）按次计费，有订阅时为 9.90 €。如需更大用量，可通过销售团队订购 Enterprise 套餐。

有SLA吗？

是的：Business 和 Enterprise 套餐提供 99.9 % 的月度可用性，并根据实际偏差给予账单金额 10 至 50 % 的抵扣。服务状态会在 Certyneo 状态页面上持续公布。

您使用什么身份验证？

在 Authorization 标头中传入 API 密钥（Bearer sk_live_… 或 sk_test_…）。密钥可在仪表板中创建和吊销，立即生效。对于代表您的用户执行操作的第三方应用，可使用带 authorization code 流程和 PKCE 的 OAuth 2.0。

如何验证webhook的HMAC签名？

每个 Webhook 都带有 X-Certyneo-Signature 签名标头：即使用您端点的密钥，对原始请求正文计算得到的十六进制 HMAC SHA-256。请在服务器端基于未经修改的正文重新计算，并以恒定时间进行比较（Node 中使用 crypto.timingSafeEqual，Python 中使用 hmac.compare_digest）。

是否有官方 SDK？

尚未发布。API 可从任何语言通过 HTTP 直接调用，也可以根据 OpenAPI 规范，使用 openapi-generator 或同类工具生成带类型的客户端。无代码方面，Certyneo 也已上架 Make、n8n、Postman 和 RapidAPI。

可以免费测试吗？

可以：创建免费版账户，并在仪表板中生成 sk_test_ 密钥。免费版账户创建的第一个测试密钥还会赠送一天的 Standard 套餐。借助 Postman 集合，无需编写代码即可依次完成最初的几次调用。

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

EchoSign 于 2011 年被 Adobe 收购，先后更名为 Adobe Sign 和 Adobe Acrobat Sign：其 API 仍然存在，但价格不公开，需要通过 Adobe 销售团队获取企业报价，通常按年度交易量分档。相比之下，Certyneo 公开价格：生产环境 API 访问权限从 19 €/月的 Standard 套餐起即已包含，可在线订购、无需报价，还提供免费测试密钥，让您在付费前评估 API。

准备集成电子签名了吗？

免费测试密钥、OpenAPI 规范、签名 Webhook。立即开始。

阅读文档 与Certyneo开发者交流