Коли підрядник каже «зробимо інтеграцію через API», у голові виникає щось складне й дороге. Насправді за цими словами — проста побутова ідея, яку ви щодня використовуєте, самі того не помічаючи. Розберемося без жаргону: що це, навіщо й скільки коштує.
API — це офіціант
Уявіть ресторан. Ви не заходите на кухню, не берете каструлі й не питаєте кухаря, де сіль. Ви кажете офіціантові, що хочете, він передає це на кухню й приносить вам результат. Вам не треба знати, як влаштована кухня — досить уміти зробити замовлення.
API — це офіціант між програмами. Ваш сайт «замовляє» у Нової пошти статус посилки. У банку — підтвердження оплати. У CRM — створення нової угоди. І отримує відповідь. Сайту не треба знати, як влаштована Нова пошта зсередини — досить знати, як звернутися до її API й що воно поверне.
Кожен великий сервіс, з яким ви хочете з'єднатися — банк, служба доставки, CRM, Rozetka, месенджер — має своє «меню» API: список того, що можна запитати й що зробити. Інтеграція — це навчити ваш сайт правильно робити замовлення з цього меню.
Навіщо це бізнесу
Головна цінність — прибрати людину-посередника, яка вручну переносить дані з одного місця в інше. А ще це нудна, повільна робота з помилками. Приклади, які закривають реальний біль:
- Замовлення з сайту одразу з'являється в CRM — без ручного переносу.
- Оплата на сайті сама підтверджується банком — статус міняється миттєво.
- ТТН Нової пошти створюється прямо із замовлення, а трек їде клієнту в SMS.
- Залишки на сайті синхронізуються зі складом і 1С/BAS — не продали те, чого немає.
- Товари й ціни їдуть на Rozetka та Prom без подвійного заведення.
Кожна така інтеграція економить години ручної роботи щотижня — і прибирає помилки, які людина неминуче робить, копіюючи дані руками.
Інтеграція vs експорт-імпорт файлів
Важлива різниця, яку часто плутають, — і від неї залежить ціна й результат.
Експорт-імпорт файлів — людина вивантажує файл з однієї системи й заливає в іншу. Періодично, руками. Дешево й просто, але завжди із запізненням і ризиком, що хтось забуде.
Інтеграція через API — системи обмінюються самі, у реальному часі, без людини.
Приклад: при файловому обміні ви щовечора вивантажуєте замовлення з сайту й заливаєте в облік. При інтеграції замовлення потрапляє в облік тієї ж секунди, як його оформили. Якщо ваш процес терпить добову затримку — файлів досить, і не переплачуйте. Якщо потрібен реальний час (склад, оплати, статуси) — потрібне API.
Вебхук: коли система сама вас повідомляє
Ще одне слово, яке варто знати, бо воно робить інтеграції швидшими й дешевшими.
Звичайний запит до API — це коли ваша система сама питає: «є щось нове?». Робити це доводиться постійно, і це витратно. Вебхук — навпаки: інша система сама стукає до вас, щойно щось сталося.
Приклад: замість того щоб щохвилини питати банк «оплатили?», ви даєте банку свою адресу, і він сам повідомляє вас у момент оплати. Швидше, економніше, надійніше. Тому серйозні інтеграції — платежі, статуси доставки, події в CRM — будують саме на вебхуках. Якщо підрядник каже «зробимо на вебхуках» — це добрий знак.
Головна пастка: «інтеграція», якої немає
Слово «інтеграція» в рекламі означає що завгодно. Перед тим як планувати, перевірте три речі — інакше отримаєте не те, що очікували:
1. Чи є в сервісу взагалі API. Буває, що замість повноцінного API сервіс дає лише вивантаження файлів. Тоді реального часу не буде — тільки періодичний обмін, хоч би як його називали.
2. Чи віддає API те, що вам потрібно. API може бути, але обмеженим: віддає статус замовлення, але не склад. Або дозволяє читати, але не створювати. «API є» ще не означає «API вміє те, що ви задумали».
3. Чи немає жорстких лімітів. Багато API обмежують кількість запитів за хвилину. Для великого магазину це буває вузьким місцем. Це технічна деталь, але саме через неї «готова» інтеграція раптом гальмує.
Тому чесний підрядник перед обіцянкою «інтегруємо з X» читає документацію X і перевіряє, що потрібне реально можливе. Обіцянка без цієї перевірки — це обіцянка навмання.
Готові конектори чи розробка
Не кожну інтеграцію треба писати з нуля. Є проміжний шлях — no-code-платформи на кшталт Zapier чи Make, які вже вміють з'єднувати популярні сервіси без програмування. Логіка вибору:
- Готовий конектор / no-code — коли з'єднуєте популярні сервіси стандартним способом, обсяги невеликі. Швидко й дешево на старті, але ви платите за кожну дію й залежите від чужої платформи.
- Своя інтеграція через API — коли потрібна нестандартна логіка, великі обсяги або повний контроль. Дорожче разово, але без щомісячної плати за кожен крок і без стелі.
Правильний вибір залежить від обсягів і того, наскільки нетиповий ваш процес.
Скільки коштує
Чесна відповідь: залежить від того, наскільки готове API з іншого боку. Інтеграція з сервісом, у якого гарна документація й сучасне API (Нова пошта, монобанк, популярні CRM) — передбачувана робота. Інтеграція зі старою системою без нормального API або з екзотичним сервісом — довше й дорожче, бо доводиться обходити обмеження.
Тому оцінка інтеграції завжди починається не з вашого сайту, а з питання «а що вміє той бік». І це нормально, коли підрядник спершу вивчає API, а вже потім називає ціну.
Головне
API — це спосіб, яким програми обмінюються даними без людини: як офіціант, що передає ваше замовлення на кухню й приносить результат. Інтеграція через API відрізняється від експорту файлів тим, що працює в реальному часі й без людини, а вебхук робить її швидшою — інша система сама повідомляє вас про подію, а не ви її опитуєте. Головна пастка — «інтеграція», яку обіцяють, але API з іншого боку немає, воно обмежене або має ліміти; тому чесна оцінка починається з перевірки, що вміє той бік. І не все треба писати з нуля: популярні зв'язки закривають готові конектори, а своя розробка потрібна для нестандартної логіки й великих обсягів.
Ми в Obliko перед будь-якою інтеграцією вивчаємо API з обох боків, чесно кажемо, що реально можливо, а що — лише файловий обмін, і радимо, де досить готового конектора, а де варто зробити свою інтеграцію. Напишіть, які системи хочете з'єднати, — перевіримо, наскільки це здійсненно, ще до оцінки.
Що таке API простими словами?
API — це спосіб, яким одна програма звертається до іншої й отримує від неї дані чи виконує дію, без участі людини. Аналогія — офіціант у ресторані: ви не заходите на кухню самі, а кажете офіціантові, що хочете, він передає замовлення й приносить результат. API — це такий офіціант між програмами: сайт «замовляє» у Нової пошти статус посилки, у банку — підтвердження оплати, у CRM — створення угоди, і отримує відповідь. Вам не треба знати, як влаштована чужа кухня, — досить знати, як зробити замовлення.
Чим інтеграція відрізняється від експорту-імпорту файлів?
Експорт-імпорт — це коли людина вивантажує файл з однієї системи й завантажує в іншу руками, періодично. Інтеграція через API — коли системи обмінюються даними самі, у реальному часі, без людини. Приклад: при експорті ви щовечора вивантажуєте замовлення з сайту й заливаєте в CRM; при інтеграції замовлення потрапляє в CRM тієї ж секунди, як його оформили. Файловий обмін дешевший і простіший, але завжди із запізненням і ризиком, що хтось забуде його зробити.
Що таке вебхук?
Якщо звичайний запит до API — це коли ваша система сама питає «є щось нове?», то вебхук — навпаки: інша система сама повідомляє вас, щойно щось стається. Приклад: замість того щоб щохвилини питати банк «оплатили?», ви даєте банку адресу, і він сам стукає до вас у момент оплати. Вебхуки економніші й швидші за постійні опитування, тому серйозні інтеграції будують саме на них — платежі, статуси доставки, події в CRM.
Чому інтеграція, яку обіцяли, часто не працює як очікувалось?
Найчастіші причини: у сервісу немає повноцінного API, а є лише вивантаження файлів (тоді це не реальний час, а періодичний обмін); API є, але обмежене — віддає не всі потрібні дані або має ліміти на кількість запитів; сторони по-різному зрозуміли, що саме синхронізується. Тому перед обіцянкою «інтегруємо з X» треба перевірити, що API у X реально існує, віддає потрібне й дозволяє те, що ви задумали, — а не покладатися на слово «інтеграція» в рекламі.
Потрібен сайт або застосунок?
Розробляємо під ключ — від дизайну до запуску. Порахуємо ваш проєкт безкоштовно.