REST API — это как roadmapping: пока все кивают, кажется, что договорились.

REST API — это как roadmapping: пока все кивают, кажется, что договорились.
А потом один тимлид приносит PATCH, второй — PUT, третий — «давайте просто вернём 200 и не будем драматизировать». И вот уже у вас не API, а сезонный сериал с конфликтом ролей.

На собеседовании особенно весело:
— Чем отличается системный аналитик, который читал REST, от того, кто его проектировал?
— Тем, что первый уверенно говорит «делаем как в учебнике», а второй уже мысленно ставит 409, потому что знает, где именно всё сломается.

В FinTech и e-commerce это вообще отдельный жанр:
создать заказ, обновить заказ, отменить заказ, «а можно ещё чуть-чуть поменять заказ, но чтобы статус не трогался» 😅
И в этот момент на сцену выходит вечный спор: PATCH или PUT, 400 или 409, «это ошибка клиента или просто бизнес решил передумать?».

Самое драматичное — не ошибки в коде.
Самое драматичное — когда API уже почти готов, а потом приходит stakeholder и говорит:
«Нам бы ещё одну маленькую сущность. И чтобы без миграций. И чтобы вчера».