API-интеграция ломается не на коде, а на плохом ТЗ и слабой проверке данных

API-интеграция ломается не на коде, а на плохом ТЗ и слабой проверке данных

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

Перед запуском проверьте 4 вещи:
• какие поля обязательны, а какие можно не передавать;
• кто источник истины: CRM, сайт или ERP;
• как система ведёт себя при таймауте, 4xx и 5xx;
• куда падают ошибки: в лог, в чат, в задачу.

Отдельно смотрите на лимиты запросов и идемпотентность. Если повторная отправка создаёт дубль сделки, заказа или заявки, интеграция опасна уже на базовом уровне. Нужен внешний ID, проверка на повтор и понятный сценарий повторной попытки.

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

Чем проще контракт между системами, тем дешевле поддержка. Начинайте не с «как передать», а с «что считать корректными данными» — это экономит больше всего времени.