API REST — eIDAS

API электронной подписи для разработчиков

Встройте электронную подпись eIDAS в свое приложение за несколько часов. REST, надежные веб-буки, Node/Python/Ruby SDK, бесплатный бесплатный песочник.

Создать учетную запись разработчика Документация API

Бесплатная песочница · 99,95% времени безотказной работы · EU Sovereign Hosting

REST + OpenAPI 3.1

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

Надежные веб-буки

Автоматический ретри с экспоненциальным резервом, подпись HMAC SHA-256, журнал событий, доступный для поиска.

Соответствие eIDAS-коренному

AES, AES-Q и QES подписи доступны через API флаг. Квалифицированная аудитная дорога включена, ЕС-квалифицированные сертификаты TSP.

Латентность < 200 мс

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"
  }'

Для создания конверта, добавления документа, подпись и URL веб-вхока достаточно одного запроса POST. API возвращает sign_url, готовый к обмену.

Официальный SDK Node.js

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

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

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

События конверта и получателя, проверяемая подпись 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 часа с экспоненциальным резервом.
Журнал событий, доступный для просмотра с панели управления: просмотр каждой попытки, возвращенный HTTP-статус, корпус.
URL webhook, настраиваемый по конверту (override) или глобальному в проекте.

Зачем нужен специальный интерфейс для электронной подписи?

Внедрение электронной подписи в продукт не просто. Вам нужны гарантии юридической соответствия (eIDAS), техническая надежность (вебхуки, которые действительно приходят), и суверенитет данных (европейский хостинг, чтобы избежать Cloud Act).

Разработанный разработчиками и для разработчиков, он следует современным REST-конвенциям: курсорная pagination, ключи idempotency, версия по URL, OpenAPI 3.1 для автоматического создания ваших клиентов.

Соответствие eIDAS объяснено для разработчиков

В соответствии с регламентом eIDAS определены три уровня подписи: простой (SES), продвинутый (AES) и квалифицированный (QES). Certyneo API позволяет выбирать уровень по конверту через поле `signature_level`. По умолчанию AES (достаточно для 95% случаев B2B). QES доступен для документов, требующих строгой юридической эквивалентности с рукописной подписью (нотариальные акты, государственные контракты).

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

Бесплатный песочница без ограничений

Все производственные функции доступны, кроме того, что подписи не имеют юридической силы (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-подписки: sandbox бесплатен и не ограничен, API-ключ генерируется из dashboard, а доступ к REST API production включён уже в план Standard за 19 €/мес — webhooks и SDK входят, без платежей за подпись.

Standard — 19 €/мес: 100 конвертов/мес, REST API + webhooks, 10 пользователей
Business — 39 €/мес: 300 конвертов/мес, массовая рассылка, веб-формы
Business Pro — 99 €/мес: 1000 конвертов/мес, API высокой частоты (300 запр/мин), неограниченное количество пользователей

Квалифицированная подпись (QES) — это отдельный продукт, оплачиваемый за акт: 9,90 € за подпись, доступный на всех тарифах, включая Бесплатный.

Для больших объёмов или потребности в договорном обязательстве (SLA, выделенный DPA, годовая выставление счётов), план Enterprise приобретается у коммерческой команды. В любом случае цены являются публичными — сравните их перед тем как вы обязываетесь.

Проверка вопросов API

Каков предел пробела API?

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

Сколько стоит API?

Sandbox (ключи sk_test_) бесплатен и не ограничен. Доступ к REST API production включён уже в план Standard за 19 €/мес (100 конвертов/мес), затем Business за 39 €/мес и Business Pro за 99 €/мес с растущими квотами; квалифицированная подпись (QES) — отдельный продукт, тарифицируется 9,90 € за подпись. Для больших объёмов или усиленного SLA план Enterprise заключается с коммерческой командой.

Есть ли СЛЗ?

99,95% времени безотказной работы на бизнес и корпоративных планах (до 4 часов безотказной работы в год).

Какую аутентификацию вы используете?

Для интеграций OAuth (многопользовательская платформа) мы предлагаем OAuth 2.0 Client Credentials на Enterprise плане.

Как проверить HMAC-сигнатуру вебхука?

Каждый вебхук включает в себя заголовок X-Certyneo-Signature, содержащий HMAC SHA-256 из полезной нагрузки, подписанный с помощью вашего секретного вебхука. С серверной стороны пересчитайте HMAC и сравнивайте в постоянном времени (timing-safe comparison). Официальный SDK делает это автоматически через webhook.verify(payload, signature, secret).

SDK открыты для пользователей?

Да. SDK Node, Python и Ruby на GitHub под лицензией MIT. Вы можете форкировать, вносить вклад или просто проверять их. Бинарные файлы публикуются на npm, PyPI и RubyGems под именным пространством @certyneo / certyneo.

Можно мне пройти тест без регистрации?

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

Сколько стоит API EchoSign (ставший Adobe Acrobat Sign)?

EchoSign был куплен Adobe в 2011 году, переименован в Adobe Sign, затем в Adobe Acrobat Sign: API по-прежнему существует, но цена не опубликована и согласуется по смете у коммерческой команды Adobe, обычно по годовым транзакциям. В отличие от этого, Certyneo опубликовывает цены: доступ API production включён уже в план Standard за 19 €/мес, подписываемый онлайн без сметы, с бесплатным неограниченным sandbox для оценки API перед оплатой.

Готовы к интеграции электронной подписи?

Бесплатный беслимитный песочница, полная документация, официальные SDK.

Прочитайте документацию Поговорить с разработчиком Certyneo