До змісту

API та інтеграції

| Стаття: 3 хв читання | Системи бізнесу

API (application programming interface) — набір правил і можливостей усередині програми, через які інша програма може з нею взаємодіяти, на відміну від людського інтерфейсу. Це «контракт» між програмою, що пропонує API, і сторонніми програмами чи пристроями (MDN). Інтеграція — підключення двох систем через такий контракт, щоб вони обмінювалися даними без ручного перенесення.

Простими словами

Коли ви шукаєте відділення Нової пошти на сайті магазину, сайт не лізе в базу перевізника. Він надсилає запит у спеціальне «віконце» (API) і отримує відповідь: список міст і відділень. Так само сайт може передати замовлення в CRM, а облікова система — повернути залишки.

Інтеграція — це робота, яка використовує API: хтось налаштовує, які дані, коли й у який бік передавати.

Як системи обмінюються даними

Є кілька способів. Усі вони зустрічаються в магазині.

  • Запит за запитом (API). Одна система сама звертається до іншої: «дай залишки», «створи накладну». Правила запиту описані в документації API. Для опису API існують стандарти: специфікація OpenAPI має версію 3.2.1 від 10 вересня 2026 року (OpenAPI Initiative).
  • Webhook. Система сама повідомляє іншу, коли щось сталося: оплачено замовлення, змінився статус. За Wikipedia, це «користувацькі HTTP-колбеки»: при події джерело надсилає запит на заданий вами адрес, і отримувачу не треба постійно опитувати систему (Wikipedia, Webhook).
  • Файли. Вивантаження таблиці чи XML, як у товарних фідах. Просто, але повільно й без миттєвих оновлень.
  • Готовий модуль чи конектор. Постачальник уже зробив зв'язку між двома популярними сервісами; ви лише вмикаєте її й вводите ключ.

Без інтеграцій дані між системами переносять руками: замовлення з сайту в CRM, залишки в облікову систему, накладні в службу доставки. Це повільно й дає помилки.

Типові зв'язки магазину:

Коли потрібно

Коли ви помічаєте, що хтось щодня переносить дані між системами або що залишки на сайті розходяться зі складом.

Коли ще рано

Коли систем дві-три й обмін у кілька замовлень на день. Тоді готового модуля, а то й ручного перенесення вистачає. Не варто будувати складну зв'язку заради порядку, якого ще не потрібно.

Безпека й надійність

  • API-ключі — це «паролі» між системами. Не розсилати їх у месенджерах і не публікувати.
  • Webhook слід перевіряти: Wikipedia називає розповсюджені способи автентифікації вхідних запитів (спільний секрет, цифровий підпис, HMAC-підпис у заголовку) і перевірку часу запиту проти повторів (Wikipedia, Webhook).
  • Що відбувається при збої: інтеграція має повторювати відправлення й показувати помилки, інакше замовлення «зависає» непоміченим.
  • Хто відповідає: постачальник сервісу чи ваш інтегратор. Це варто знати до запуску.
  • Персональні дані клієнтів, які ходять між системами, підпадають під закон про захист персональних даних. Це не юридична порада.

Типові помилки

  • Інтеграція в один бік, а дані змінюються в обох системах: розбіжності.
  • Немає єдиного ключа замовлення в різних системах.
  • Ніхто не стежить за помилками обміну.
  • Закрита система без API: пізніше з нею нічого не з'єднати. Перед вибором сервісу питайте, чи є відкритий API й експорт даних (SaaS).

FAQ

Що таке API простими словами? Спосіб, яким одна програма просить іншу про дані чи дію за заздалегідь описаними правилами.

Що таке інтеграція в інтернет-магазині? Автоматичне з'єднання систем: сайт передає замовлення в CRM чи облік, служба доставки повертає статус.

Чим webhook відрізняється від API? Через API ви самі запитуєте дані. Webhook — система сама повідомляє вас, коли щось сталося.

Чи потрібен програміст для інтеграції? Для готового модуля зазвичай ні, для нестандартної зв'язки так. Залежить від систем, які ви з'єднуєте.

Пов'язані терміни

Джерела

Конкретні можливості API Нової пошти дивіться в її документації (developers.novaposhta.ua).

Свіжих даних про те, як українські магазини інтегрують системи, немає.

Хочете перевірити це на своєму магазині?

Розробка e-commerce

Індивідуальні e-commerce рішення та інтеграції: від доопрацювань до складних систем.

Про послугу →

Поділитися

Читайте також

  • OMS і WMS

    | Стаття: 3 хв читання

    OMS (order management system) — система керування замовленнями: приймає замовлення з усіх каналів, веде їхні статуси й вирішує, звідки й чим їх виконувати. WMS (warehouse management system) — система керування складом: фіксує надходження й відвантаження…

  • CRM

    | Стаття: 2 хв читання

    CRM (customer relationship management) — підхід і, зазвичай, програма для керування взаємодією з клієнтами: вона зберігає дані про них, аналізує їх і допомагає узгоджувати продажі, маркетинг і підтримку (Wikipedia, CRM).

  • CDP

    | Стаття: 4 хв читання

    CDP (customer data platform) — програмне забезпечення, яке збирає дані про клієнтів із усіх систем компанії, зводить їх до одного профілю людини, зберігає цей профіль постійно й віддає його іншим системам: аналітиці, маркетингу, підтримці. CDP Institute у…

  • Облікова система

    | Стаття: 3 хв читання

    Облікова система — програма, у якій компанія веде бухгалтерський і товарний облік: документи про продажі й закупівлі, залишки на складі, гроші на рахунках, розрахунки з контрагентами. З неї беруть дані для звітності й податків.