Что это
Способ, которым одна программа обращается к другой за данными или командами — например, ваш сайт запрашивает у Telegram отправку сообщения, а у Яндекса — данные по заказу.
Как используем
Если у сервиса (CRM, склад, маркетплейс, банк) есть API — подключаем его к вашей автоматизации напрямую, без ручной работы человека и без копирования данных вручную.
Где API нужен бизнесу
- Заявка с сайта или из бота сама попадает в CRM и в таблицу, её никто не копирует руками.
- Бот после оплаты сам продлевает доступ в другой системе: в панели VPN, в кабинете, в сервисе.
- Нужно узнавать о событии на маркетплейсе раньше менеджера: освободился слот приёмки, пришёл заказ.
- Сайт или приложение показывает данные, которые живут в другом месте: каталог, остатки, профиль.
- Два ваших сервиса должны работать с одними данными, а не держать две копии, которые со временем расходятся.
Какие бывают
- REST API — у каждой сущности свой адрес, запросы «получить», «создать», «изменить». Так устроены API маркетплейсов, панели Marzban и наших интернет-магазинов.
- Вебхук — обратное направление: сервис сам присылает событие на ваш адрес. Нужен, когда важна мгновенная реакция.
- Опрос по расписанию — если вебхуков у сервиса нет, программа сама спрашивает API раз в несколько секунд.
- Внутренний API — между вашими же сервисами, закрыт от внешнего мира и защищён общим секретом.
Как мы это используем
- Для поставщика Wildberries бот опрашивает API каждые 30 секунд и присылает в Telegram свободный слот приёмки с прямой ссылкой на бронирование: мониторинг слотов.
- Заявка из Telegram-бота через n8n создаётся в Bitrix24 и дописывается в Google Таблицу, а смена статуса сделки возвращается вебхуком: автоматизация заявок.
- Бот Tech Poly VPN создаёт и продлевает пользователей в панели Marzban через её REST API, а деньги, сроки и скидки хранит у себя.
- У бота управления аккаунтами нет своей базы: каждое действие идёт во внутренний API сервиса с общим секретом в заголовке, поэтому аккаунты живут в одном месте.
- Витрина интернет-магазина берёт каталог и оформляет заказы через API на FastAPI.
Какие ваши системы можно связать, разбираем на бесплатном аудите в разделе Автоматизация.
Типичные проблемы
- Две правды. Если данные есть и у вас, и в чужой системе, они расходятся. В Tech Poly VPN срок подписки попадает в базу бота только после того, как его вернула панель, поэтому бот не считает подписку активной, когда трафик уже отключён.
- Сбой посередине. Оплата подтверждена, а панель не ответила. Нужен откат: заявка возвращается в ожидание, скидка не сгорает.
- Повторы. Два администратора нажали «Подтвердить» одновременно или событие пришло дважды. Операция должна быть идемпотентной: в Tech Poly VPN это блокировка строки в базе при подтверждении.
- Чужой сервис меняется без вас. YouTube регулярно меняет защиту, и бот загрузки видео при сбоях первым делом обновляет yt-dlp. Интеграцию с чужим API нужно сопровождать.
- Ключи и токены. Их место в n8n или в
.env на сервере, а не в коде и не в файле сценария.
Когда это не нужно
Если данные переносятся раз в месяц и их немного, ручная выгрузка в таблицу дешевле интеграции. Если у сервиса нет ни API, ни вебхуков, связка становится хрупкой, и это мы честно говорим на аудите, а не обещаем «подключим всё».