REST API — eIDAS

API за електронен подпис за разработчици

Вградете електронния подпис по eIDAS в своето приложение: REST API, webhooks, подписани с HMAC, вградено подписване в iframe и безплатни тестови ключове още от безплатния акаунт.

Създайте акаунт за разработчици Документация за API

Безплатни тестови ключове · SLA 99,9 % (Business и Enterprise) · Хостинг в ЕС

REST и OpenAPI

Предвидими endpoints, чист JSON, стандартни HTTP кодове. Спецификация OpenAPI за изтегляне, с която да генерирате собствени клиенти.

Доверчиви уебсайтове

5 опита с нарастващи интервали, подпис HMAC SHA-256, неуспешните събития могат да се изпратят повторно от таблото. Без polling за програмиране.

Начало на програмата

Обикновен, усъвършенстван (OTP чрез SMS) и квалифициран подпис, избиран за всеки плик с полето signatureLevel. Одитна следа с времеви печат се прилага към всеки подписан документ.

Хостинг в ЕС

Сървъри в Германия, Франция и Испания. Публикувани лимити на заявките по план и заглавки X-RateLimit във всеки отговор. SLA 99,9 % за Business и Enterprise.

Старт с три извиквания

Качете 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: API се използва с вградения fetch на Node 18 или с всеки HTTP клиент. Спецификацията 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"
}

HMAC SHA-256 подписи на всеки полезен товар проверете автентичността на сървърната страна.
Автоматично повторно опитване в случай на временен отказ: 5 опита за приблизително 1 ч 20 мин с експоненциален backoff.
Неуспешните събития се показват в таблото и могат да се изпратят повторно с едно кликване. След 5 последователни неуспеха крайната точка се спира и получавате известие.
До 5 крайни точки в Standard, 15 в Business и 50 в Business Pro, всяка абонирана за избраните от вас събития.

Защо да имаме специален API за електронни подписи?

Вграждането на електронния подпис в продукта ви не е лесно.Трябва да имате гаранции за законово съответствие (eIDAS), техническа надеждност (вебхукове, които наистина идват) и суверенитет на данните (европейски хостинг, за да избегнете Закона за облаците).Certyneo API покрива и трите.

Създаден от разработчици за разработчици, той следва конвенциите на REST: версия в URL адреса (/api/v1), страниране с page и limit, JSON грешки с машинно четим код, спецификация OpenAPI за генериране на клиентите ви. Без SOAP, без XML, без изненади.

Изяснено за разработчиците eIDAS съответствие

Регламентът eIDAS определя три нива на подпис: обикновен (SES), усъвършенстван (AES) и квалифициран (QES). API на Certyneo позволява да изберете нивото на всеки плик с полето signatureLevel: SIMPLE (по подразбиране), ADVANCED или QUALIFIED. Обикновеният подпис покрива повечето обичайни търговски договори; QES се използва, когато нормативен акт или получател изисква равностойност със саморъчния подпис.

Технически усъвършенстваното ниво автоматично активира OTP чрез SMS и изисква телефонен номер за всеки подписващ. Одитната следа получава времеви печат по стандарта 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.
Актуализирате базата данни и уведомявате потребителя (електронна поща, в приложение и т.н.).

Безплатни тестови ключове

Ключовете sk_test_ са достъпни във всички планове, включително Безплатен, и тестовите пликове не намаляват месечната ви квота. В план Безплатен те могат да се изпращат само до собствения ви имейл адрес и са ограничени до 20 заявки на час; платените планове достигат от 200 до 1 000 заявки на час. Тестовите данни се изтриват след 30 дни. Първият тестов ключ на безплатен акаунт отключва и един безплатен месец в план Standard.

А ако не искате да пишете код

Всичко, което прави този API, може да се управлява и без писане на един ред, от поток : създаване на плик, изпращането му, реагиране на подпис, извличане на запечатания PDF и неговата пътека на одит. Същата база, с визуален конструктор вместо HTTP клиент. Вижте интеграцията Power Automate и Microsoft 365.

Мигриране от DocuSign или Yousign

Ако вече имате интеграция с DocuSign или Yousign, терминологията е близка: envelopes → envelopes, recipients → recipients, webhooks за статус → webhooks. Ръководството за миграция от DocuSign и Yousign към Certyneo описва стъпките — от експорта на шаблоните до превключването на webhooks.

Мигрирате ли от Adobe Acrobat Sign (по-рано EchoSign, след това Adobe Sign)? Съпоставянето е еднакво преко — agreements → envelopes, participants → recipients, webhooks → webhooks. Сравнение на Certyneo и Adobe Acrobat Sign →

Цена на API за електронен подпис: където да купите абонамент?

Не ви трябват оферта или поръчка, за да купите абонамент за API за подписване: тестовите ключове са безплатни, API ключът се генерира от таблото, а достъпът до продукционния REST API е включен от план Standard за 19 €/месец — с включени webhooks, без такса за обикновен подпис.

Standard — 19 €/месец: 100 плика/месец, REST API + webhooks, 10 потребители
Business — 39 €/месец: 300 плика/месец, масово изпращане, уеб формуляри
Business Pro — 99 €/месец: 1 000 плика/месец, високочестотен API (300 заявки/мин), неограничени потребители

Квалифицираният подпис (QES) се таксува на брой и се заплаща при изпращане: 9,90 € за подпис с абонамент, удържани от запазената карта след изчерпване на включените QES в Business и Business Pro, и 14,90 € без абонамент.

За големи обеми или необходимост от договорно ангажиране (SLA, посветен DPA, годишно фактуриране), плана Enterprise се придобива от търговския екип. Във всички случаи цените са публични — сравнете ги, преди да се ангажирате.

За по-задълбочено четене

Проверка на въпросите API

Какъв е граничният пропуск на API?

Лимитът се прилага за всеки ключ, на минута, според плана: 60 заявки в Standard, 120 в Business, 300 в Business Pro и 1 000 в Enterprise. Всеки отговор съдържа заглавките X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset; над лимита API връща 429 със заглавка Retry-After.

Колко струва АПИ?

Тестовите ключове (sk_test_) са безплатни във всички планове. Достъпът до продукционния REST API е включен от план Standard за 19 €/месец (100 плика/месец), след това Business за 39 €/месец и Business Pro за 99 €/месец с нарастващи квоти; квалифицираният подпис (QES) се таксува на брой, 9,90 € с абонамент. За по-големи обеми план Enterprise се договаря чрез търговския екип.

Има ли АЛС?

Да: 99,9 % месечна наличност в плановете Business и Enterprise, с кредит по фактурата от 10 до 50 % според установеното отклонение. Състоянието на услугата се публикува непрекъснато на страницата за статус на Certyneo.

С какво се удостоверявате?

API ключ в заглавката Authorization (Bearer sk_live_… или sk_test_…). Ключовете се създават и отменят от таблото с незабавно действие. За приложение на трета страна, което действа от името на вашите потребители, е наличен OAuth 2.0 с потока authorization code и PKCE.

Как да проверя HMAC подписа на уебхук?

Всеки webhook носи заглавка за подпис X-Certyneo-Signature: HMAC SHA-256 в шестнадесетичен вид на суровото тяло на заявката, изчислен с тайния ключ на вашата крайна точка. Изчислете го отново на сървъра върху непромененото тяло и сравнете в константно време (crypto.timingSafeEqual в Node, hmac.compare_digest в Python).

Има ли официален SDK?

Все още не е публикуван. API се извиква директно по HTTP от всеки език, а спецификацията OpenAPI позволява да генерирате типизиран клиент с openapi-generator или подобен инструмент. Без код Certyneo е достъпен и в Make, n8n, Postman и RapidAPI.

Мога ли да тествам, без да плащам?

Да: създайте безплатен акаунт и генерирайте ключ sk_test_ от таблото. Първият тестов ключ на безплатен акаунт отключва и един безплатен месец в план Standard. Колекцията за Postman ви позволява да изпълните първите извиквания, без да пишете код.

Колко струва EchoSign API (станал Adobe Acrobat Sign)?

EchoSign е придобит от Adobe през 2011 г. и преименуван на Adobe Sign, а след това на Adobe Acrobat Sign: API все още съществува, но цената му не е публична и изисква корпоративна оферта от търговския екип на Adobe, обикновено на нива според годишните транзакции. Certyneo, напротив, публикува цените си: достъпът до продукционния API е включен от план Standard за 19 €/месец, с абонамент онлайн без оферта и с безплатни тестови ключове, за да оцените API, преди да платите.

Готови ли сте за електронния си подпис?

Безплатни тестови ключове, спецификация OpenAPI, подписани webhooks. Започнете сега.

Прочетете документацията Говорете с разработчик на Certyneo