Если у вас уже есть собственная CRM, ERP или любая внутренняя система, подписание и документооборот не обязательно выносить в отдельный интерфейс — их можно встроить прямо в ваш продукт. Партнёрский REST API еОбіг создан именно для этого: продуктовые команды, интеграторы и компании с собственными системами подключают его обычно за пару дней. Разберём, насколько это просто и с чего начать.
Почему интеграция проста
Партнёрский API еОбіг — это обычный REST поверх HTTPS, поэтому он ложится в любой стек без экзотических библиотек. Базовый путь — api.eobig.com/partner/v1, версия зашита прямо в URL, так что обновления API не сломают ваш код: вы сами решаете, когда переходить на новую версию.
Документация идёт в формате OpenAPI 3.0 с интерактивным Swagger UI. Это значит, что вы можете открыть спецификацию, нажать «попробовать» прямо в браузере, а затем сгенерировать готовый клиент на своём языке — без ручного написания обёрток. Поведение предсказуемо и на границах: в ответах есть заголовки лимита запросов (rate limit), поэтому вы всегда видите остаток и планируете нагрузку без сюрпризов.
Отдельная важная деталь о безопасности: приватный ключ подписи на сервер не попадает. Вы формируете подпись на стороне клиента в формате CMS/CAdES, а в API передаёте уже готовую подпись — платформа принимает её как есть. Подробнее об этой модели — в статье о безопасности подписания в браузере, а о самом стандарте — в материале что такое квалифицированная электронная подпись.
Авторизация двумя заголовками
Никаких сложных OAuth-танцев: авторизация держится на двух заголовках. X-Access-Token — ваш ключ доступа, X-Organization — идентификатор компании, от имени которой работает интеграция. Ключ можно отозвать в любой момент, так что ротация и контроль доступа остаются в ваших руках.
Вот как выглядит типичный запрос на загрузку документа:
POST https://api.eobig.com/partner/v1/documents
X-Access-Token: <ваш_ключ>
X-Organization: <идентификатор_компании>
Content-Type: multipart/form-data
file=@contract.pdf
В ответ вы получаете идентификатор документа, с которым дальше работаете: добавляете подписи, предоставляете доступ участникам или создаёте гостевую ссылку. Простая аутентификация означает, что первый рабочий запрос вы сделаете за считаные минуты после получения ключа.
Ключевые возможности API
Всего доступно около двадцати эндпоинтов, покрывающих полный жизненный цикл документа — от загрузки до архива. Вот важнейшие группы:
| Группа | Что позволяет |
|---|---|
| Документы | Загрузка, список и поиск, получение оригинала и подписанной версии, удаление |
| Организация | Переименование, теги, архивирование, пакетная проверка статусов |
| Подписи | Получить имеющиеся подписи, добавить готовую подпись CMS/CAdES |
| Доступ | Участники и общий доступ, гостевые ссылки на подпись или заполнение |
| Контрагенты | Проверка контрагента по коду ЕДРПОУ |
| Вебхуки | Подписка, список, удаление callback-адресов |
Особого внимания заслуживает возможность гостевых ссылок: ваш контрагент подписывает документ или заполняет его по ссылке БЕЗ регистрации в системе. Для интеграции это означает, что внешние стороны включаются в процесс без всякого трения — подробно этот сценарий разобран в статье отправка на подпись без регистрации.
Вебхуки: реальное время в CRM
Чтобы не опрашивать сервер в цикле «уже подписано?», подпишитесь на вебхуки. Вы указываете свой callback-URL, а еОбіг сам присылает уведомление, как только наступает событие: документ подписан, подписание не удалось, контрагент отказался, а также события ИИ. Ваша CRM обновляет статус сделки в ту же секунду.
Каждый вызов вебхука несёт HMAC-подпись в заголовке — вы проверяете подлинность сообщения и отбрасываете подделки. Если ваш сервис на мгновение недоступен, система делает повторные попытки доставки, так что ни одно событие не потеряется. В отличие от многих сервисов документооборота, у нас вебхуки — штатная часть API, а не отдельная надстройка.
ИИ прямо в API
Это то преимущество, которого у большинства платформ нет вообще: искусственный интеллект доступен прямо через API. Вы можете программно сгенерировать документ по текстовому описанию, отредактировать имеющийся или построить шаблон — не выводя пользователя из вашего интерфейса.
Поскольку такие задачи требуют времени, они выполняются асинхронно: вы ставите запрос, а о завершении узнаёте через вебхук. Для ИИ действует отдельная квота, так что генерация не конкурирует с обычными запросами. Представьте: менеджер в вашей CRM описывает сделку словами — и через несколько секунд получает готовый черновик договора прямо в своём рабочем окне. Что ещё умеет ИИ платформы — на странице ИИ.
Как начать
Self-service выдачи ключей в кабинете пока нет, поэтому доступ к партнёрскому API выдаёт команда. Чтобы получить ключ, оставьте заявку через демонстрацию или обратитесь к нам напрямую — мы выдадим доступ и поможем с первой интеграцией.
Дальше — стандартный путь: откройте Swagger UI, сгенерируйте клиент, сделайте первый запрос на загрузку документа, подпишитесь на вебхуки и прогоните один сценарий от начала до конца. Полный перечень инструментов платформы собран на странице возможностей, а базовые принципы интеграции документооборота — в материале об интеграции документооборота через API.
Коротко о главном
- Партнёрский REST API
api.eobig.com/partner/v1с версионированием в пути — интеграция обычно за пару дней. - Авторизация простыми заголовками
X-Access-TokenиX-Organization; ключ можно отозвать. - Приватный ключ не хранится на сервере — подпись CMS/CAdES формируется на стороне клиента.
- Около двадцати эндпоинтов, гостевые ссылки без регистрации, проверка по ЕДРПОУ.
- Вебхуки с HMAC-подписью и повторами доставки — реальное время без опроса.
- ИИ прямо в API — уникальное преимущество для генерации и редактирования документов.
Хотите встроить подписание и документооборот в свой продукт? Начните бесплатно на portal.eobig.com или закажите демонстрацию — покажем API на примере ваших процессов и поможем с интеграцией. Оценить тарифы можно на странице цен.