Восстановление сломанной API-интеграции
Заказы перестали попадать с сайта в CRM, документы зависают или статусы расходятся? Найдём причину сбоя и восстановим существующую API-интеграцию. Проверим передачу данных, безопасную повторную отправку и уведомление об остановке. Сотрудник сможет видеть, что произошло с конкретным заказом или документом.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Заказы или обращения перестали попадать во внешнюю систему, хотя сайт продолжает принимать их и показывает посетителю успешную отправку.
- После обновления API, смены токена или сертификата часть методов возвращает ошибки, а сотрудники переносят данные вручную.
- Интеграция работает периодически: одни события проходят, другие зависают, повторяются или создают дубли в CRM и учётной системе.
Что именно мы сделаем
Восстанавливаем схему движения данных, изучаем код, документацию и журналы, затем воспроизводим сбой на безопасном контрольном событии.
Проверяем адреса методов, авторизацию, токены, сертификаты, права приложения, ограничения частоты и изменения версии внешнего API.
Сопоставляем обязательные поля, типы данных, справочники и идентификаторы, исправляем обработку ответов, вебхуков и подписей событий.
Добавляем защиту от дублей, повтор после временной ошибки, понятный статус операции и сохранение исходного запроса для разбора.
Прогоняем обычные, повторные и ошибочные сценарии, восстанавливаем доступные зависшие записи и настраиваем уведомление о критической остановке.
Что входит в стоимость
24 900 ₽ за всю работу
Фиксированная цена покрывает диагностику и восстановление действующего обмена, обработку временных ошибок и контроль остановки. Сохранившиеся зависшие записи проверим и передадим повторно. Небольшие связанные уточнения включены; результат доведём до приёмки за указанную сумму.
Что будет готово
Передадим вам
- Исправленный код или настройки интеграции с работающей передачей выбранных сущностей и статусов.
- Журнал запросов и ответов с понятным идентификатором события, причиной ошибки и возможностью безопасного повтора.
- Протокол контрольных сценариев и краткая инструкция для сотрудника, который наблюдает обмен и разбирает новые ошибки.
Перед сдачей проверим
- Контрольный заказ, заявка или документ проходит полный путь и появляется во внешней системе с правильными полями и идентификаторами.
- Повторная доставка того же события сохраняет одну бизнес-операцию, а временный сбой приводит к контролируемой повторной попытке.
- Критическая ошибка видна в журнале и вызывает выбранное уведомление с данными, достаточными для быстрого разбора.
Как это выглядит на практике
Заказы снова попадают в CRM
Типичная ситуация: после изменения внешнего API заказы остаются на сайте, а менеджер переносит их в CRM вручную. Нужно вернуть автоматическую передачу и разобраться с накопившейся очередью.
- 01
Создаём контрольный заказ и видим отказ API из-за изменившегося формата поля телефона.
- 02
Обновляем преобразование данных и проверяем остальные обязательные поля по актуальной документации.
- 03
Повторно отправляем зависшие записи с защитой от создания второй сделки.
- 04
Настраиваем уведомление, которое сообщает номер заказа и ответ API при следующей критической ошибке.
Что понадобится для работы
Для выполнения работы
- Доступ к коду интеграции, журналам и очереди обмена. Способ безопасного доступа определим перед работой.
- Документация API, сведения о последних обновлениях и примеры успешного и зависшего заказа, заявки или документа.
- Сотрудник, который сможет проверить поля и итоговый статус в обеих системах; тестовая учётная запись или выбранное время контрольной операции.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 21 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Можно ли починить интеграцию другого разработчика?
Да. Сначала разбираем существующий код, журналы и документацию, затем воспроизводим сбой и вносим точечные изменения в найденной точке отказа.
Что происходит после изменения версии API?
Сопоставляем прежние и актуальные методы, поля, ответы и способ авторизации, после чего обновляем обмен и проверяем основные сценарии.
Можно ли передать накопившиеся записи?
Да, если исходные данные сохранились. Проверим очередь и журналы, затем выполним контролируемый повтор с защитой от дублей.
Как быстро заметить следующий сбой?
Добавляем журналирование, контроль времени последней успешной операции и уведомления о критических ответах либо остановившейся очереди.
Чем восстановление отличается от новой интеграции и защиты от сбоев?
Восстановление подходит, когда обмен уже был настроен и перестал выполнять свою задачу. Исправление ошибки, безопасные повторы, защита от дублей и контроль остановки уже входят в эту работу. Новую интеграцию выбирают, когда нужно связать системы с нуля. Отдельная защита от сбоев нужна для действующего обмена, который требуется специально доработать под задержки и отказы внешнего сервиса.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
В цену уже включены небольшие связанные уточнения, которые появляются после старта: например, дополнительное поле или изменение уведомления. Этот запас относится к новым уточнениям и не ограничивает время на основную работу: согласованный результат выполняем полностью за фиксированную сумму. Порядок расчёта резерва закрепляем в договоре; подробности есть в дополнительных вопросах об условиях работы ниже.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.