API-интеграция ломается не из-за кода, а из-за плохого ТЗ между системами

API-интеграция ломается не из-за кода, а из-за плохого ТЗ между системами

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

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

Отдельно фиксируйте правила по времени: что должно передаваться сразу, что можно отправлять пачкой, а что лучше не трогать без ручной проверки. Иначе интеграция начинает «экономить» шаги там, где это опасно.

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