API (Application Programming Interface) — це набір правил, за якими одна програма звертається до іншої і отримує від неї дані або дію. Ваш сайт не «заходить усередину» банку чи Нової Пошти: він надсилає запит у тому форматі, який та система очікує, і отримує назад відповідь. Саме API робить можливими оплату карткою, розрахунок доставки та автоматичне створення заявки в CRM.
Для власника бізнесу API — це не технічна дрібниця, а межа між «сайт-візитівка» і «сайт, який працює замість менеджера». Поки інтеграцій немає, хтось руками переносить замовлення в таблицю, дзвонить у службу доставки і звіряє оплати. Кожна інтеграція забирає одну таку рутину.
Нижче — пояснення на пальцях, схема запит-відповідь, перелік API, які в Україні підключають найчастіше, реальні вилки цін і помилки, через які інтеграції ламаються.
API простими словами: офіціант у ресторані
Уявіть ресторан. Ви сидите за столиком і хочете пасту. Ви не йдете на кухню, не берете сковорідку і не питаєте кухаря, де сіль. Ви кличете офіціанта, називаєте страву зі списку — і за кілька хвилин отримуєте тарілку.
Офіціант тут і є API. Кухня (чужа система — банк, перевізник, CRM) не пускає вас всередину і не мусить. Меню — це документація: перелік того, що взагалі можна замовити, і в яких формулюваннях. Офіціант знає правила: як передати замовлення, що робити, якщо страва закінчилася, і як принести вам відповідь.
З цієї аналогії відразу випливають три речі. Замовити можна тільки те, що є в меню — якщо у платіжного сервісу немає потрібної функції, її не «допише» жоден розробник. Формулювати треба точно, інакше принесуть не те. І кухня може відповісти «немає» — ваш сайт має вміти це коректно показати клієнту.
Як працює запит і відповідь
Технічно обмін виглядає простіше, ніж здається. Це чотири кроки:
- Ваш сайт формує запит: адреса методу, ключ доступу і дані — наприклад, сума платежу та номер замовлення.
- Запит іде на сервер сервісу, який перевіряє ключ і права.
- Сервіс виконує дію і повертає відповідь — зазвичай у форматі JSON: статус, ідентифікатор, повідомлення про помилку.
- Сайт розбирає відповідь і показує результат людині: «Оплату прийнято», «Відділення №12», «Спробуйте ще раз».
Ключ доступу (API-ключ або токен) — це ваш перепустка. Він доводить сервісу, що запит справді від вашого сайту. Тому ключ — така сама цінність, як пароль від адмінки: про це ще буде окремо.
Важливо, що відповідь приходить не миттєво і не завжди успішна. Сервіс може бути на технічних роботах, ліміт запитів вичерпано, дані невалідні. Нормально зроблена інтеграція завжди передбачає, що станеться в такому випадку.
Які API найчастіше підключають сайтам в Україні
Це не теоретичний список, а те, що реально просять клієнти студії. Терміни вказані для випадку, коли сайт уже є і документація сервісу в порядку.
| API | Що дає бізнесу | Скільки займає підключення |
|---|---|---|
| LiqPay / WayForPay | Оплата карткою прямо на сайті, без переказу «на картку менеджера» | 2–5 днів |
| Stripe | Прийом оплат від закордонних клієнтів у валюті | 3–7 днів |
| Нова Пошта | Вибір відділення у формі, розрахунок вартості, автоматична ТТН | 3–6 днів |
| KeyCRM / Bitrix24 | Заявки падають у CRM з джерелом і менеджером, нічого не губиться | 2–5 днів |
| Google Maps | Карта проїзду і філії на сторінці контактів | 0,5–1 день |
| Telegram | Сповіщення про нову заявку в чат за кілька секунд | 0,5–1 день |
Для інтернет-магазину базовий набір — оплата плюс доставка плюс CRM: без них магазин просто перекладає роботу на менеджера. Для корпоративного сайту зазвичай достатньо CRM, карт і Telegram-сповіщень.
Чому інтеграції коштують грошей
Найчастіше питання звучить так: «У сервісу ж є готове API, чому це не година роботи?». Тому що підключення — це не тільки виклик методу. Це облікові записи і ключі, тестове середовище, узгодження полів (у вас «Ім'я клієнта», у CRM — `contact_name`), обробка помилок, повторні спроби, логи і перевірка на реальних замовленнях.
Наші реальні вилки: типова інтеграція — $200–500 (оплата, Нова Пошта, CRM зі стандартними полями, месенджер). Складна — $1 000–3 000: нестандартна логіка, синхронізація залишків в обидва боки, стара облікова система без нормальної документації, кілька сервісів, які мають узгоджуватися між собою.
Приклад із практики — магазин автозапчастин Raul Avto: там підбір деталей і калькулятор працюють на інтеграціях, і саме вони, а не дизайн, визначили строк проєкту.
Типові помилки при роботі з API
Ключі у відкритому коді
Найдорожча помилка. API-ключ, залишений у файлах фронтенду або залитий у публічний репозиторій, знаходять автоматичні сканери за години. Далі — чужі запити від вашого імені, вичерпаний ліміт, у гіршому випадку списання коштів. Ключі мають зберігатися тільки на сервері, у змінних оточення, і мінятися при зміні підрядника.
Немає обробки помилок
Сервіс недоступний — і клієнт бачить білий екран або вічний спінер. Замовлення втрачено, а власник дізнається про це через тиждень. Правильно: зрозуміле повідомлення людині, повторна спроба, запис у лог і сповіщення адміністратору.
Ніхто не дивиться логи
Інтеграція мовчки перестала працювати після оновлення на боці сервісу — таке буває регулярно. Без логів і моніторингу це виявляють за падінням продажів, а не за помилкою.
Все підключають одразу
Спокуса зробити «всі інтеграції на старті» затягує запуск на місяці. Робочий підхід — оплата і заявки спершу, решта після перших реальних замовлень.
Що почитати далі
Щоб зібрати повну картину, подивіться, що таке CMS — саме через неї ви керуєте контентом, поки API керує обміном даними. І окремо — як працює адмін-панель сайту, де видно, куди саме приходять дані з інтеграцій.
