REST API — eIDAS

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

Вградете електронния си подпис eIDAS в приложението си за часове. REST, надеждни уебхукове, Node/Python/Ruby SDK, безплатен безграничен пясъчен кутий.

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

Безплатен Sandbox · 99,95% време на работа · ЕС суверен хостинг

REST + OpenAPI 3.1

Предсказуеми крайни точки, чист JSON, стандартни HTTP кодове.

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

Автоматичен ретроинг с експоненциален архив, HMAC SHA-256 подпис, запис на събития, без кодиращи избора.

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

AES, AES-Q и QES подписи, достъпни чрез API флаг.

Латентност < 200 ms

API хоствана в Страсбург (ЕС), p95 < 200 ms от Европа.

Старт след 5 минути.

Създайте първия си плик с един HTTP запитване.

cURL Създаване на плик

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 запитване е достатъчно, за да се създаде плик, да се добави документ, подписател и уебхук 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

Node TypeScript SDK предоставя пълно типографиране, автоматично управление на грешки с ретри и конструктор на течни обвивки.

Вебхукове реагирайте в реално време

События на плик и получател, проверяема 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" }
  ]
}

HMAC SHA-256 подписи на всеки полезен товар проверете автентичността на сървърната страна.
Автоматичен ретро в случай на неуспех: 5 опита за 24 часа с експоненциален backoff.
Проверяван от таблото дневник на събития: вижте всеки опит, върнат HTTP статус, тялото.
URL на webhook, който може да бъде конфигуриран като надпис или като глобален в проекта.

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

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

Създадена от и за разработчици, тя следва съвременните REST конвенции: маркиране на страниците на базата на курсора, idempotency keys, версиониране на URL адреси, OpenAPI 3.1 за автоматично генериране на вашите клиенти.

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

Регламентът eIDAS определя три нива на подпис: прост (SES), напреднал (AES) и квалифициран (QES). Certyneo API позволява да се избира ниво по плик чрез поле `signature_level`. По подразбиране е AES (достатъчно за 95% от случаите B2B). QES е налично за актове, които изискват строга правна еквивалентност с ръчно написания подпис (нотариални актове, публични поръчки).

От техническа гледна точка AES изисква силна автентификация на подписащия (OTP чрез SMS по подразбиране, KYC видео по избор) и времеобелязан аудит. QES добавя квалифициран сертификат, издаден от квалифициран ЕС TSP. Всичко това се управлява от API викаш крайната точка, ние се погрижим за останалото.

Препоръчителна архитектура за интегриране

Най-често срещаният модел на интеграция е следният:

Вашият backend извиква POST /v1/envelopes, за да създаде плика и получава sign_url, който да представи на потребителя.
Пренасочвате потребителя към sign_url или го вграждате в iframe (с вашия брандинг чрез Pro план).
След като подписите са завършени, Certyneo ще извика вашия уебхук с събитието envelope.completed.
Актуализирате базата данни и уведомявате потребителя (електронна поща, в приложение и т.н.).

Безплатен безграничен Sandbox

Пълен с безплатни и неограничени функции, всички производствени функции са достъпни, освен че подписите нямат юридическа стойност (PDF е маркиран като SANDBOX).

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

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

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

Ако вече имате DocuSign или Yousign интеграция, API-то за картографиране е директно: пликове → пликове, получатели → получатели, status webhooks → status 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 и SDK включени, без такса за подпис.

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

Квалифицираният подпис (QES) е отделен продукт, таксуван по акт: 9,90 € за подпис, достъпен във всички пакети, включително Безплатен.

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

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

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

По подразбиране 1 000 заявки на минута, като при поискване този брой може да бъде увеличен за приложения с висока натовареност (фабрики, платформи с много потребители). Заглавката X-RateLimit-Remaining във всеки отговор показва оставащия лимит. При превишаване на лимита API-то връща код 429 с Retry-After.

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

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

Има ли АЛС?

99.95% работоспособност на бизнес и Enterprise плановете (максимум 4 часа безработица годишно).

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

Bearer token (API ключ) в заглавието Authorization. Ключовете се въртят от таблото, с незабавно отмяна. За OAuth интеграции (многостранна платформа) предлагаме OAuth 2.0 Client Credentials на Enterprise план.

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

Всеки уебхук включва X-Certyneo-Signature заглавие, съдържащо HMAC SHA-256 на полезния товар, подписан с вашия таен уебхук.

SDK-тата отворени ли са?

Да. SDK Node, Python и Ruby са на GitHub под лиценз MIT. Можете да ги форк, допринася или просто да ги одитирате.

Може ли да тествам без регистрация?

Да, чрез интерактивните примери в документацията на API: /developers/playground. Заявленията се насочват към споделен пример за пясъчен кутия, без да се изисква ключ. За сериозна употреба, създадете безплатен акаунт за разработчици (безграничен пясъчен кутия).

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

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

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

Безплатна безгранична пясъчна кутия, пълна документация, официални SDK.

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