REST API — это не «просто JSON по HTTP». Это набор решений, где одна неверная развилка потом ломает интеграции

REST API — это не «просто JSON по HTTP». Это набор решений, где одна неверная развилка потом ломает интеграции, ретраи и аналитику ошибок.

Что обычно проверяют на практике:
1) Идемпотентность.
PUT можно безопасно повторять, POST — не всегда. Если у клиента таймаут, а у сервера запрос уже создал сущность, без идемпотентного ключа вы получите дубли.
2) PATCH vs PUT.
PUT заменяет ресурс целиком, PATCH — частично. Но в реальных API спор не про терминологию, а про контракт: что считать полным обновлением и как не стереть поле, которое клиент не отправил.
3) 409 Conflict.
Это не «любая ошибка». Код нужен, когда запрос валиден, но конфликтует с состоянием системы: версия записи, уникальный ключ, гонка между двумя апдейтами.

Где чаще всего ошибаются:
— смешивают 400 и 422
— не фиксируют правила версионирования
— не продумывают поведение при повторном запросе

Итог простой: хороший API — это не красивый endpoint, а предсказуемое поведение под нагрузкой и при сбоях 🧩