Що таке API простими словами: як сайти обмінюються даними
Що таке API простими словами
API (Application Programming Interface) — це спосіб, яким два програмних продукти спілкуються між собою. Аналогія: API — це офіціант у ресторані. Ви (сайт) кажете офіціанту (API) що хочете. Він йде на кухню (інший сервіс), забирає замовлення і приносить вам.
Ви не заходите на кухню самі, не знаєте як готують страву — вам це і не потрібно. Ви знаєте тільки меню (документацію API) і як зробити замовлення (формат запиту).
Для власника бізнесу API — це можливість з'єднати сайт з іншими сервісами без ручної роботи. Замовлення з сайту автоматично потрапляє в CRM. Оплата автоматично перевіряється через платіжну систему. Трекінг-номер автоматично отримується від Нової Пошти. Все це — через API.
Приклади API у повсякденному житті
Ви використовуєте API щодня, навіть не знаючи:
- Google Maps на сайті ресторану — сайт через API Google Maps запитує карту з потрібною адресою і вбудовує її на сторінку
- Вхід через Google/Facebook — сайт через API соцмережі перевіряє вашу особу без створення окремого акаунту
- Оплата на сайті — коли ви натискаєте «Оплатити», сайт через API LiqPay або Monobank передає дані про замовлення і отримує підтвердження оплати
- Прогноз погоди в додатку — додаток через API метеосервісу запитує прогноз для вашого міста
- Відстеження посилки — сайт магазину через API Нової Пошти перевіряє статус доставки і показує вам
Потрібна консультація?
Безкоштовно розберу ваш проєкт і дам рекомендації
Навіщо API вашому сайту
API потрібне коли ви хочете автоматизувати те, що зараз робите вручну:
- Без API: клієнт заповнив форму на сайті → лист прийшов на email → менеджер вручну вносить дані в CRM → вручну створює накладну → вручну відправляє підтвердження
- З API: клієнт заповнив форму → дані автоматично в CRM → автоматична накладна Нової Пошти → автоматичний SMS клієнту з трекінг-номером
Для малого бізнесу з 5-10 замовленнями на день — ручна обробка ще можлива. При 50+ замовленнях — API-інтеграції економлять години роботи щодня.
Популярні інтеграції через API
Для українського бізнесу найчастіше потрібні:
- Оплата — LiqPay, Monobank Acquiring, WayForPay, Fondy
- Доставка — Нова Пошта (створення накладних, трекінг), УкрПошта, Meest
- CRM — KeyCRM, HubSpot, Pipedrive (передача заявок)
- Месенджери — Telegram Bot API (повідомлення про замовлення), Viber
- SMS — Turbosms, Alphasms (підтвердження, нагадування)
- Маркетплейси — Prom.ua, Rozetka (синхронізація товарів)
- Аналітика — Google Analytics, Facebook Pixel (передача конверсій)
- Бухгалтерія — Checkbox (фіскальні чеки), Дія.Підпис
Як це працює технічно (спрощено)
Ваш сайт відправляє запит на сервер іншого сервісу. Запит містить: що ви хочете (створити замовлення, перевірити оплату) і дані (номер замовлення, сума). Сервер обробляє запит і відповідає: результат (успіх/помилка) і дані (номер накладної, статус оплати).
Для ідентифікації використовується API-ключ — унікальний пароль, який ви отримуєте при реєстрації в сервісі. Без ключа сервіс не відповість на запит. Ключ потрібно зберігати в безпеці — як пароль від банку.
Формат спілкування зазвичай — JSON (текстовий формат даних). Кожен сервіс має документацію API — інструкцію які запити можна робити, які дані передавати і що очікувати у відповідь.
Rate limit — обмеження кількості запитів за хвилину. Наприклад, Нова Пошта дозволяє 300 запитів на хвилину. Якщо ваш магазин масово генерує накладні — потрібно враховувати цей ліміт у коді, інакше сервіс тимчасово заблокує доступ.
Що буває коли API недоступне: сервіс впав, інтернет зник, API-ключ протермінувався. Грамотний розробник завжди обробляє такі ситуації — користувач бачить зрозуміле повідомлення («Спробуйте пізніше»), а не білий екран. При розробці сайту це закладається на етапі проектування.
Типи API: REST, webhook, GraphQL
Коли розробник каже «підключимо через REST API» або «налаштуємо webhook» — ось що це означає:
- REST API — найпоширеніший тип. Ваш сайт сам запитує дані: «дай статус замовлення», «створи накладну». Працює за принципом «запит → відповідь». 90% інтеграцій для бізнесу — це REST API
- Webhook — зворотний підхід. Інший сервіс сам повідомляє ваш сайт коли щось сталося: «оплата пройшла», «клієнт написав у чат». Не потрібно постійно перевіряти — повідомлення приходить автоматично
- GraphQL — гнучкий запит, де ви точно вказуєте які дані потрібні. Використовується рідше, в основному в складних додатках. Для типового бізнес-сайту зазвичай не потрібний
На практиці REST і webhook часто працюють разом. Наприклад: ви створюєте замовлення через REST API Нової Пошти, а коли посилка змінює статус — Нова Пошта надсилає webhook на ваш сайт. Вам не потрібно запам'ятовувати ці терміни — достатньо розуміти що робити через API можна активно (запитувати) і пасивно (отримувати сповіщення).
Готовий плагін чи кастомна інтеграція
Не кожна інтеграція потребує розробника з нуля. Часто є готові рішення:
| Критерій | Готовий плагін | Кастомна інтеграція |
|---|---|---|
| Швидкість | 1-2 години | 1-5 днів |
| Вартість | Безкоштовно або до 2 000 грн | Від 3 000 грн |
| Гнучкість | Обмежена налаштуваннями плагіна | Повна — під ваші процеси |
| Підтримка | Залежить від автора плагіна | Ваш розробник |
Обирайте плагін якщо: працюєте на WordPress/WooCommerce і потрібна стандартна оплата або доставка. Більшість популярних сервісів мають офіційні плагіни.
Обирайте кастомну інтеграцію якщо: у вас сайт без CMS, нестандартний бізнес-процес, потрібна синхронізація з обліковою системою або кілька сервісів мають працювати разом.
Третій варіант — Zapier/Make. Ці платформи з'єднують сервіси без коду: форма на сайті → рядок у Google Sheets → повідомлення в Telegram. Підходить для тестування гіпотез і малого обсягу даних. Коли бізнес виросте — переходьте на кастомне рішення.
Скільки коштує інтеграція через API
- Готовий плагін (WooCommerce + LiqPay, WooCommerce + Нова Пошта) — безкоштовно або 500-2 000 грн за преміум-версію. Встановлення за 1-2 години
- Проста кастомна інтеграція (форма → CRM, форма → Telegram) — 1 000-5 000 грн
- Складна інтеграція (синхронізація товарів сайт ↔ маркетплейс, кастомна оплата) — 5 000-20 000 грн
- Через Zapier/Make — безкоштовно (базовий план) або від $20/міс. Налаштування без коду
Вартість залежить від складності API сервісу і вимог до інтеграції. Підключити готовий плагін оплати — 1 година. Побудувати кастомну синхронізацію з обліковою системою — кілька днів. При складанні ТЗ на сайт обов'язково вкажіть потрібні інтеграції — це суттєво впливає на вартість розробки.
Часті запитання
Зазвичай ні. Для сайту-візитки з формою зворотного зв'язку достатньо відправки email. API стає потрібним коли з'являються замовлення, оплата, доставка або потреба в CRM. Але навіть для візитки може бути корисна інтеграція форми з Telegram — повідомлення про нову заявку приходить миттєво.
Так, при правильному використанні. Сучасні API працюють через зашифроване з'єднання (HTTPS), використовують автентифікацію через ключі або токени. Головне — не зберігати API-ключі у відкритому коді і не передавати їх третім особам.
Так. Сервіс може змінити API (випустити нову версію), тимчасово бути недоступним (збій серверів) або повністю закрити доступ. Тому важливо: обирати надійних провайдерів, обробляти помилки в коді (щоб сайт не ламався якщо API недоступне), і мати план Б.
REST API — це коли ваш сайт сам запитує дані (\"дай мені статус замовлення\"). Webhook — це коли інший сервіс сам повідомляє ваш сайт про подію (\"оплата отримана\"). REST — ви питаєте, webhook — вам кажуть. Обидва підходи часто використовуються разом.
Zapier і Make — платформи для з'єднання сервісів без коду. Наприклад: форма на сайті → рядок у Google Sheets → повідомлення в Telegram. Підходить для малого обсягу (до 100 операцій на місяць безкоштовно). Коли обсяг зростає або потрібна нестандартна логіка — кастомна інтеграція дешевша і надійніша.
Залежить від рівня. Готовий плагін для WordPress (LiqPay, Нова Пошта) — так, встановлення за 1-2 години з інструкцією. Zapier/Make — теж можна самостійно. Кастомна інтеграція через код — потрібен розробник. Навіть при самостійному підключенні варто проконсультуватися щодо безпеки API-ключів.
Висновок
API — це не «щось складне і технічне». Це спосіб зробити ваш сайт частиною бізнес-процесу: автоматизувати оплату, доставку, CRM і комунікацію з клієнтами. Для інтернет-магазину API-інтеграції — обов'язкові. Для сайту послуг — корисні починаючи з 10+ заявок на день.
Потрібна інтеграція сайту з CRM, оплатою або доставкою? Зроблю сайт під ключ з усіма потрібними API-підключеннями. Розрахуйте вартість у калькуляторі.