API-интеграция ломается не в коде, а в постановке задачи

API-интеграция ломается не в коде, а в постановке задачи

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

Самые частые провалы:
— нет единого источника данных: CRM, таблица и бот живут по своим правилам;
— не описаны статусы и поля, поэтому данные приходят, но не собираются в процесс;
— нет обработки сбоев: запрос завис, а повторная отправка уже создала дубликат;
— никто не отвечает за поддержку: интеграция работает «пока не трогать».

В рабочей схеме у API должны быть три слоя: входные данные, правила проверки и журнал ошибок. Минимум логируйте время запроса, ID сущности, код ответа и причину отказа. Тогда можно быстро понять, где проблема: в источнике, в передаче или в принимающей системе.

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

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