Интеграция сайта с сервисами по API

Что входит

Реализуем надёжные интеграции по API: CRM, эквайринг, службы доставки, маркетплейсы, «Госключ» и внутренние сервисы — с обработкой ошибок и идемпотентностью.

Типичная ситуация: заявка с сайта живёт в почте, менеджер заводит её в CRM руками, бухгалтер отдельно сверяет платежи, а трек-номер доставки клиенту отправляют копипастом. Каждый перенос данных — место, где теряется заявка или появляется опечатка. Чем больше внешних сервисов подключено, тем заметнее эти потери.

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

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

Этапы работы

1. 01Анализ контрактов и сценариев обмена
2. 02Реализация интеграции с обработкой ошибок
3. 03Логирование, ретраи и мониторинг
4. 04Документация и передача

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

Как строится работа над интеграцией?

Начинаем с документации API и сценариев обмена: что передаём, в какую сторону и как часто. Затем реализуем обмен и проверяем его на тестовом контуре сервиса, включая поведение при ошибках и таймаутах. После этого подключаем логирование и оповещения о сбоях, пишем короткую техническую документацию и передаём интеграцию в работу.

Чем плох ручной перенос данных?

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

С какими сервисами это работает?

С теми, у кого есть открытый программный интерфейс: CRM, эквайринг, службы доставки, маркетплейсы, сервисы проверки контрагентов и внутренние системы. Обмен по HTTP с обычными форматами данных — стандартная задача. Ограничения появляются там, где у сервиса нет API вовсе или доступ выдаётся только с конкретных адресов и требует отдельного согласования.

Что потребуется от вас?

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