REST API без ошибок — это как growth-эксперимент без северной метрики: все что-то делают, но потом никто не по

REST API без ошибок — это как growth-эксперимент без северной метрики: все что-то делают, но потом никто не понимает, что именно сломалось.

3 типовых фейла на собесе и в проде:
— PUT vs PATCH путают, потому что «ну это же оба обновление». Потом частичное обновление затирает поле, и привет, инцидент.
— 409 Conflict игнорируют, хотя именно он нужен, когда два запроса одновременно пишут в одну сущность. Без него у вас не API, а гонка 🏁
— Коды ошибок выбирают по ощущениям: 400, 404, 422 — как карта несуществующего мира.

Хороший API проектируют не “красиво”, а предсказуемо:
1 гипотеза о сценарии,
1 контракт,
1 понятная ошибка,
1 проверка на конкуренцию изменений.

Если инженер спорит про PATCH, это нормально. Если не может объяснить, что произойдет при повторном запросе — уже нет.