Что такое API и вебхук на языке владельца бизнеса, чем отличается обмен по расписанию от событийного, что делать с падениями и почему интеграции ломаются молча.
Интеграция кажется простой, пока обе системы работают. Реальная сложность появляется в исключениях: сервис не ответил, ответил дважды, ответил через час, вернул половину данных. Именно в этих ситуациях рождаются задвоенные заказы и пропавшие заявки.
Раздел объясняет базовые механизмы связи систем и требования, которые стоит предъявлять к подрядчику, чтобы обмен переживал сбои без вашего участия.
Дубль рождается не из ошибки в коде, а из обязательного повтора: связь оборвалась после отправки, но до ответа, и система не знает, доехал заказ или нет. Разбираем механику, четыре источника дублей, три шага приёмки и порядок склейки того, что уже наплодилось.
ДеньгиДве сметы на одну и ту же задачу — 68 000 и 398 000 ₽ — разложены построчно. Что именно даёт разницу, во что обходится отсутствие каждой строки в деньгах потерянных заявок и на каком месяце дешёвая связка догоняет дорогую по расходам.
ТехнологииОдин сквозной пример — заказ с сайта доезжает до склада за семь шагов — и на нём разобраны восемь слов из сметы подрядчика с денежным последствием каждого. Плюс порог: при каком числе операций выгрузка в таблицу дешевле и надёжнее любой интеграции.
Раздел выходит частями. Ниже — темы, которые уже расписаны и ждут очереди. Если нужен ответ по одной из них прямо сейчас — напишите нам, разберём вашу ситуацию отдельно и без ожидания.
Требование «в реальном времени» звучит в каждом брифе и в половине случаев удорожает проект вдвое без пользы. Даём методику: считаем допустимую задержку от бизнес-процесса, а не от желания, и показываем гибрид — события для срочного, расписание для сверки — который на практике надёжнее чистых схем.
Очередь — самая недооценённая строка сметы: её вычёркивают первой и потом платят потерянными заявками. Объясняем на аналогии с приёмной, зачем нужен буфер между системами, как устроены повторные попытки с нарастающей паузой и что такое отстойник для сообщений, которые не удалось обработать.
Спор «мы отправили» — «мы не получали» решается за пять минут, если журнал сделан правильно, и не решается никогда, если нет. Даём состав журнала обменов, который заказчик вправе требовать, и объясняем сквозной идентификатор — механизм, позволяющий проследить одну заявку через все системы.
Интеграции почти никогда не падают целиком — они деградируют: растёт доля ошибок, копится очередь, стареет последний успешный обмен. Даём восемь измеримых сигналов с порогами, схему оповещения, которая доходит до человека, и объясняем, почему проверка «сервис отвечает» ничего не гарантирует.
Не шаблон ТЗ на 40 страниц, а 12 пунктов, отсутствие которых гарантированно приводит к спору о доплате. Каждый пункт дан формулировкой, которую можно перенести в договор, и объяснением, какой именно конфликт он закрывает.
Отказ внешнего сервиса — не авария, а штатное событие, которое случается несколько раз в год у любого поставщика. Описываем четыре линии поведения (буфер, повтор, деградация, ручной режим) и правило, какие операции нельзя откладывать ни при каких условиях.
Лимиты — причина половины сбоев в интеграциях с маркетплейсами и облачными сервисами, и почти всегда о них узнают после блокировки. Объясняем виды ограничений, механику блокировки и главный антипаттерн: продолжать долбить сервис во время бана — так окно блокировки продлевается.
Интеграция ломается не только по вине подрядчика: поставщик регулярно меняет свой API, и старая версия однажды отключается. Объясняем, как читать уведомления об изменениях, сколько времени обычно дают на переход и почему бюджет на поддержку — это в том числе бюджет на чужие обновления.
Ключ API — это доступ к данным компании, который обычно лежит в переписке с подрядчиком и живёт там годами. Разбираем, чем ключ отличается от пароля, почему у интеграции должен быть отдельный ключ с урезанными правами, и что делать в первые часы после утечки.
Пункт, который вычёркивают из сметы первым, а потом тестируют на живых заказах клиентов. Считаем, сколько тестовый контур стоит в процентах от проекта и во что обходится его отсутствие, и честно называем два случая, когда он действительно не нужен.
Отсутствие API — не приговор, но каждый обходной путь платит за скорость надёжностью. Сравниваем четыре варианта (файловый обмен, разбор почты, программный робот, прямой доступ к базе) по цене, хрупкости и юридическим рискам, и объясняем, почему прямой доступ к чужой базе почти всегда плохая идея.
Восемь из десяти проблем обмена начинаются не в коде, а в справочниках, по которым не договорились. Даём метод: определить хозяина по каждому справочнику, выбрать поле сопоставления, описать правило разрешения конфликтов — и только потом писать интеграцию.
Второй честный отказ кластера: малому бизнесу с тремя системами шина не нужна, и продавать её — значит продавать сложность. Даём числовой критерий перехода, разбираем доступные в РФ варианты промежуточного слоя и объясняем, почему западные конструкторы сценариев сегодня не рабочая рекомендация.
Опишите процесс словами, голосом или файлами — вернёмся с картой процесса, вариантом решения и предварительной вилкой бюджета. Бесплатно и без обязательств.
