Перейти к содержимому
← Все статьи
7 мин чтения

Интеграция систем по API: вебхуки, очереди и повторы

Соединить две системы в хороший день просто. Вся работа — в плохие дни: другая сторона недоступна, запрос пришёл дважды, поле изменило формат. Рассказываем, как мы проектируем интеграции, чтобы сбои были видны и устранимы.

Сначала опишите поток данных

До кода ответьте на бумаге: какая система — источник истины для каждого фрагмента данных, какое событие запускает обмен, в какую сторону идут данные и как быстро они должны дойти. Большинство ошибок интеграций возникает, когда две системы считают своим одно и то же поле.

Опрос или вебхуки

При опросе вы по расписанию спрашиваете у другой системы изменения: просто и предсказуемо, но с задержкой и лишней нагрузкой. С вебхуками другая система сама обращается к вам, когда что-то происходит: быстро, но вы должны уметь принимать запросы в любой момент и справляться с пропущенными.

Надёжная схема часто использует оба: вебхуки для скорости и периодическую сверку, которая подбирает потерянное.

Сделайте операции идемпотентными

Сети повторяют запросы, и вы тоже будете. Если одно событие пришло дважды, результат должен быть таким же, как при однократном получении. Сохраняйте внешний идентификатор события или запроса и игнорируйте повторы, либо проектируйте обновления как «установить состояние X», а не «прибавить единицу». Без этого повторы превращаются в дубли заказов и двойные платежи.

Поставьте очередь между системами

Не заставляйте пользователя ждать медленный сторонний API. Примите событие, сохраните его, быстро ответьте и обработайте в фоне через очередь. Очередь также сглаживает всплески, позволяет приостановить обработку, пока другая сторона недоступна, и показывает, что ожидает.

Повторы, лимиты и сбои

Временные ошибки повторяйте с растущими паузами; ошибки, которые никогда не исправятся, например некорректные данные, не повторяйте. Соблюдайте лимиты запросов чужого API. События, которые продолжают падать, должны попадать в отдельное место, где человек сможет их изучить и перезапустить, чтобы одна плохая запись не блокировала всё, что за ней.

Безопасность и наблюдаемость

Проверяйте подписи или секреты вебхуков, не храните ключи API в коде и давайте каждой интеграции только нужные права. Логируйте каждый обмен с идентификатором и настраивайте оповещения на рост очереди и повторяющиеся ошибки. Интеграция, за которой никто не следит, ломается молча, и клиенты замечают это раньше вас. Подробный пример для CRM и ERP — в статье интеграция CRM и ERP.

Вопросы

Частые вопросы

Не нашли ответ — спросите на созвоне или в Telegram.

Что делать, если у другой системы нет API?

Варианты есть: обмен файлами, доступ к базе данных, где это допустимо, или документированный импорт и экспорт. Что возможно, подтверждаем после знакомства с системой и её условиями использования.

Как тестируется интеграция?

На тестовом контуре другой стороны, если он есть, а если нет — на записанных примерах запросов и имитации сбоев. Сценарии сбоев важны не меньше основного пути.

Можете ли вы взять существующую интеграцию, которая ломается?

Да. Сначала находим, где она теряет или дублирует данные, добавляем логирование, затем стабилизируем, переписывая только то, что исправить нельзя.

Связанная услуга

Интеграции 1С, CRM и внешних API

Когда сотрудники переносят данные между системами вручную, ошибки и задержки становятся частью процесса. Автоматизируем обмен и сделаем его состояние понятным для вашей команды.

Об услуге
Другие статьи
6 мин чтения

Интеграция с 1С, amoCRM и ERP: архитектура надёжного обмена данными

Интеграция с 1С, amoCRM и маркетплейсами через API: организация очередей, обработка лимитов, идемпотентность запросов и сквозной мониторинг обмена данными.

Читать статью: Интеграция с 1С, amoCRM и ERP: архитектура надёжного обмена данными →
6 мин чтения

Идемпотентность API: как обрабатывать повторные запросы без дублей

Как работает идемпотентность API: заголовок Idempotency-Key, уникальные индексы в БД, повторы вебхуков и алгоритм exponential backoff с джиттером.

Читать статью: Идемпотентность API: как обрабатывать повторные запросы без дублей →
6 мин чтения

Безопасность вебхуков: подпись, верификация и защита входящих запросов

Безопасность вебхуков: подпись HMAC, проверка в постоянное время, защита от повторов по timestamp и безопасная ротация секретов.

Читать статью: Безопасность вебхуков: подпись, верификация и защита входящих запросов →
Контакт

Обсудим вашу задачу?

Тридцать минут созвона — и у вас есть понимание архитектуры, сроков и формата работы. Без обязательств.

Или напишите в Telegram →Читайте наш канал в Telegram →

Укажите Telegram или email, чтобы мы могли ответить.

Отвечаем в течение 15 минут.