Есть API, с которыми работаешь спокойно. А есть такие, где каждый новый endpoint ощущается как отдельное приключение.

И почти всегда проблема не в backend-логике, а в отсутствии нормального API-дизайна.

Когда у тебя рядом существуют:

/api/getUser
/api/deletePost
/api/updateProfileData

— это уже тревожный сигнал.

Особенно когда ответы ещё и приходят каждый раз в разном формате. Где-то массив. Где-то data. Где-то result. Где-то вообще просто boolean.

В итоге фронтенд превращается не в клиентское приложение, а в слой адаптеров между хаосом и UI.

Хороший REST API — это предсказуемость. Когда разработчик заранее понимает, как будет выглядеть следующий endpoint, ещё до чтения документации.

Именно это в production экономит огромное количество времени.