раздел 05

Шпаргалка

Всё главное на одной странице: таблица сравнения, словарь терминов и ссылки.

Сравнение видов

| Вид | Направление | Когда применять | | --- | --- | --- | | API | Вы спрашиваете - вам отвечают | Нужны данные или действие по запросу, прямо сейчас | | Webhook | Сервис сам сообщает вам | Нужно мгновенно реагировать на событие | | Файлы (CSV/JSON) | Выгрузка - загрузка | Редкий или разовый обмен, большой объём, нет прямой связи | | Общая база | Обе системы пишут в одну базу | Программы внутри компании, доверяют друг другу | | Очередь / брокер | Через посредника-буфер | Большой поток, нельзя терять сообщения | | SDK / библиотека | Готовый код в вашей программе | Чтобы не писать интеграцию с API вручную | | Iframe / виджет | Чужой блок на вашей странице | Быстро встроить чат, оплату, карту без разработки | | RPA / парсинг | Имитация действий человека | У сервиса нет API, иначе никак | | MCP | AI ходит во внешние системы | Дать AI-ассистенту доступ к вашим данным и инструментам |

Глоссарий

API
Способ, которым программы обращаются друг к другу: вы шлёте запрос - получаете ответ. Инициатор - вы, связь синхронная. Самый частый вид интеграции.
Webhook
Обратный вызов: сервис сам присылает вам уведомление, когда происходит событие. Инициатор - сервис. Противоположность API по направлению.
SDK
Готовый набор кода от сервиса, который встраивают в свою программу, чтобы не писать обращение к API вручную. Под капотом - тот же API, но проще.
Брокер сообщений
Посредник-буфер между системами. Одна кладёт сообщения в очередь, другая забирает в своём темпе. Нужен при больших потоках и чтобы ничего не потерять.
Polling
Когда программа повторно спрашивает сервис «есть новости?» через равные промежутки. Простой, но неэффективный способ узнавать о событиях. Webhook решает ту же задачу лучше.
Токен / ключ
Пароль, которым система подтверждает, что имеет право обращаться к другой. Хранят в секрете, не светят в коде и чатах, при утечке - сразу отзывают.
Push и pull
Две модели передачи. Pull - вы сами забираете данные (API). Push - данные приходят к вам сами, когда появились (webhook).

Смежные курсы

  • /api - подробно про API: endpoint, методы, ключи, как читать документацию.
  • /mcp - как устроен MCP и как подключать серверы для AI-ассистентов.
  • /telegram-bots - живой пример интеграции: бот связывает Telegram с вашим сервисом через API и webhook.