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 управляет обменом данными. И отдельно — как работает админ-панель сайта, где видно, куда именно приходят данные из интеграций.
