REST API не проектируют по учебнику. И точно не делают вид, что «GET, POST, PATCH — и поехали».

REST API не проектируют по учебнику. И точно не делают вид, что «GET, POST, PATCH — и поехали».

На собеседованиях это видно сразу: человек может перечислить методы, но спотыкается, когда нужно решить, что делать с конфликтом версии, как возвращать ошибку, и где уместнее 409, а где 422.

В реальной работе API — это не схема ради схемы, а способ не сломать жизнь клиентам, фронту и себе. Особенно в FinTech и e-commerce, где цена одной «мелкой неточности» быстро становится большой.

Проверка на зрелость тут простая:
— можно ли объяснить, почему именно этот метод, а не «как принято»;
— что произойдёт при повторном запросе;
— как API поведёт себя при частичном обновлении и спорных данных.

Самые полезные API — не самые красивые, а самые предсказуемые 🔧

Если хотите, в следующий раз разберу, какие ошибки в REST выдают «теоретика» за 5 минут разговора.