Що таке 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-підключеннями. Розрахуйте вартість у калькуляторі.

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