раздел 04

Как выбрать вид интеграции

Универсального ответа нет - выбор зависит от задачи. Но есть несколько критериев, которые почти всегда подсказывают решение.

Критерии

Есть ли API
Главный вопрос. Если у обоих сервисов есть API - почти всегда берут его. Нет API - смотрят в сторону файлов, виджетов или RPA.
Нужно ли реальное время
Реагировать мгновенно на событие - webhook. Достаточно раз в день - подойдёт обмен файлами.
Надёжность
Если терять данные нельзя даже при сбое получателя - очередь или брокер, они сохранят сообщения и доставят позже.
Безопасность
Чем чувствительнее данные, тем важнее защищённый канал, токены и контроль доступа. Общая база на сторонний сервис - плохая идея.
Объём данных
Миллионы записей разом - выгрузка файлом или очередь. Несколько значений по запросу - обычный API.

Дерево решений словами

1
У нужного сервиса есть API?
Нет - переходите к парсингу, RPA, обмену файлами или готовому виджету. Да - дальше.
2
Нужно реагировать на события мгновенно?
Да и сервис умеет webhook - берите webhook. Нет - обычный API по запросу.
3
Объём данных большой или важна гарантия доставки?
Да - добавьте очередь или брокер между системами. Нет - хватит прямого API.
4
Это разовый или редкий обмен?
Да - часто проще выгрузить и загрузить файл, чем строить постоянную связь.

Например: магазину нужно мгновенно узнавать об оплатах - webhook. Бухгалтерии нужно раз в месяц выгрузить все продажи - файл. AI-ассистенту нужно ходить в вашу базу - MCP. Логика одна: сначала смотрите, есть ли API, потом - нужна ли мгновенность и какой объём.

Про безопасность

Почти любая интеграция использует токены или ключи - это пароли, которыми системы подтверждают друг друга. Несколько правил, которые экономят нервы:

  • Не светите ключи. Не вставляйте их в публичный код, в чаты, в скриншоты. Утёкший ключ - как отданный пароль.
  • Храните ключи отдельно от кода - в защищённых переменных окружения, не в самом файле программы.
  • Давайте минимум прав. Если интеграции нужно только читать - не выдавайте ей право удалять.
  • Если ключ утёк - сразу отзывайте его и выпускайте новый. Старый перестанет работать.