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

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

Чаще всего проблемы начинаются с трёх вещей: не совпали поля, не учли формат даты, забыли про обязательные статусы. В итоге система «принимает» запрос, но бизнес-процесс дальше не движется.

Перед запуском проверьте:
— кто источник правды для каждого поля;
— какие поля обязательны, а какие можно пустыми;
— как обрабатываются дубликаты и повторные запросы.

Отдельно смотрите на ошибки: 400 и 422 обычно означают проблему в данных, 401 и 403 — доступы, 500 — сбой на стороне сервиса. Если логирование слабое, вы будете искать причину вслепую. Поэтому сохраняйте не только ответ API, но и сам запрос, заголовки, статус, время ответа и идентификатор операции.

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

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