Практика разработки

Экспертный центр WebRuta

Разбираем оценку, архитектуру, ТЗ, интеграции, риски и приёмку сложных веб-продуктов — для заказчиков, руководителей и продуктовых команд.

8 материаловРубрика: Интеграции и API
Интеграции и API

Как проектировать webhook: подпись, replay protection, дубли и порядок событий

Webhook часто выглядит как одна из самых простых интеграций. Внешний сервис отправляет: а внутри: Backend принимает JSON и делает: Кажется, что задача решена. Пока однажды тот же webhook не приходит второй раз. И система повторно: Или сначала приходит: а через несколько секунд: хотя фактически updated произошло раньше.

09.10.2026
Читать →
Интеграции и API

Как не сломать старых клиентов при изменении API

Есть endpoint: Два года он возвращает: Команда решает немного улучшить naming. Внутри новой domain model поле уже давно называется: Поэтому разработчик делает: Frontend обновили одновременно. Автотесты прошли. Новый Web-клиент работает. Релиз считается успешным.

09.10.2026
Читать →
Интеграции и API

Как происходит интеграция сайта с 1С, CRM и API: архитектура обмена данными без дублей и потерь

Интеграция сайта с 1С или CRM часто выглядит простой только на схеме. Пользователь оформляет заказ на сайте. Сайт отправляет данные в CRM. CRM передаёт информацию в 1С. Из 1С возвращаются остатки, цены и статус оплаты. Всё это можно нарисовать четырьмя прямоугольниками и несколькими стрелками.

05.10.2026
Читать →
Интеграции и API

Как проектировать API так, чтобы его можно было менять через два года: versioning, совместимость и deprecation

В первой версии веб-продукта API кажется чем-то внутренним. Есть frontend. Есть backend. Они разрабатываются одной командой и обновляются почти одновременно. Сегодня backend возвращает: Завтра разработчику становится удобнее назвать поле иначе: Frontend поправили в том же commit. Всё работает. Проходит два года.

04.10.2026
Читать →
Интеграции и API

Почему timeout внешнего API не означает, что операция не выполнилась

Интеграция отправляет запрос во внешний сервис: Через десять секунд HTTP-клиент возвращает: На первый взгляд вывод кажется очевидным: Запрос не выполнился. Нужно отправить его ещё раз. Именно в этот момент во многих системах появляется двойной возврат, второй заказ, повторная выплата или два одинаковых документа.

04.10.2026
Читать →
Интеграции и API

Как проектировать background jobs: retry, heartbeat, failed state и защита от повторного выполнения

Фоновая задача кажется простой, пока всё работает. Есть очередь. Worker получил job. Выполнил. Поставил: Готово. Но production начинается в тот момент, когда между двумя этими действиями происходит что-нибудь неприятное. Например: Если операция была: пользователь получил два письма. Если: появилось два заказа.

03.10.2026
Читать →
Интеграции и API

Как не создать двойной заказ при повторном webhook или сетевом timeout

Есть класс ошибок, который почти невозможно заметить во время обычной ручной проверки веб-продукта. Пользователь открывает корзину. Нажимает: «Оформить заказ» Backend создаёт заказ. Всё работает. QA проходит. Проект выходит в production.

28.09.2026
Читать →
Интеграции и API

Как происходит интеграция сайта с 1С, CRM и внешними API

Фраза «нужно интегрировать сайт с 1С» часто занимает одну строку технического задания. На схеме всё выглядит ещё проще: Или: Иногда рядом появляется третья стрелка: Из-за этой простоты легко представить интеграцию как несколько HTTP-запросов: отправили JSON, получили ответ, сохранили данные — готово.

22.09.2026
Читать →