раздел 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.