Якщо у вас уже є власна CRM, ERP чи будь-яка внутрішня система, підписання й документообіг не обов'язково винести в окремий інтерфейс — їх можна вбудувати прямо у ваш продукт. Партнерський REST API еОбіг створений саме для цього: продуктові команди, інтегратори та компанії з власними системами під'єднують його зазвичай за пару днів. Розберімо, наскільки це просто й з чого почати.
Чому інтеграція проста
Партнерський API еОбіг — це звичайний REST поверх HTTPS, тож він лягає в будь-який стек без екзотичних бібліотек. Базовий шлях — api.eobig.com/partner/v1, версія зашита прямо в URL, тому оновлення API не ламатимуть ваш код: ви самі вирішуєте, коли переходити на нову версію.
Документація йде у форматі OpenAPI 3.0 з інтерактивним Swagger UI. Це означає, що ви можете відкрити специфікацію, натиснути «спробувати» просто в браузері, а потім згенерувати готовий клієнт своєю мовою — без ручного написання обгорток. Поведінка передбачувана й на межах: у відповідях є заголовки ліміту запитів (rate limit), тож ви завжди бачите залишок і плануєте навантаження без сюрпризів.
Окрема важлива деталь про безпеку: приватний ключ підпису на сервер не потрапляє. Ви формуєте підпис на боці клієнта у форматі CMS/CAdES, а в API передаєте вже готовий підпис — платформа приймає його як є. Докладніше про цю модель — у статті про безпеку підписання в браузері, а про сам стандарт — у матеріалі що таке кваліфікований електронний підпис.
Авторизація за 2 заголовки
Ніяких складних 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, а не окрема надбудова.
AI прямо в API
Це та перевага, якої в більшості платформ немає взагалі: штучний інтелект доступний прямо через API. Ви можете програмно згенерувати документ за текстовим описом, відредагувати наявний чи побудувати шаблон — не виводячи користувача з вашого інтерфейсу.
Оскільки такі задачі потребують часу, вони виконуються асинхронно: ви ставите запит, а про завершення дізнаєтесь через вебхук. Для AI діє окрема квота, тож генерація не конкурує зі звичайними запитами. Уявіть: менеджер у вашій 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 на прикладі ваших процесів і допоможемо з інтеграцією. Оцінити тарифи можна на сторінці цін.