REST API без ошибок — это не про «знаю методы». Это про контракт, который переживает релизы, интеграции и чужо

REST API без ошибок — это не про «знаю методы». Это про контракт, который переживает релизы, интеграции и чужой код.

3 места, где чаще всего ломаются:
1) Идемпотентность. PUT должен быть повторяемым без побочек. Если повторный запрос меняет состояние дважды — это уже баг, а не «особенность».
2) PATCH vs PUT. PATCH — частичное изменение, но только если вы жёстко определили merge-логику. Иначе получите конфликт полей и неочевидные перезаписи.
3) Ошибки и 409. 409 нужен не «на всякий случай», а когда конфликт состояния реально можно обнаружить и обработать на клиенте. Если возвращаете 400 вместо 409, вы теряете сигнал для интеграции.

Что проверять перед релизом:
— есть ли единый формат ошибок;
— совпадает ли поведение методов с контрактом;
— можно ли безопасно ретраить запрос;
— как API ведёт себя при гонках и устаревших версиях данных.

REST ломается не в документации. Он ломается на границе между схемой данных, бизнес-правилами и ожиданиями клиента ⚙️