Основы REST API

Часть курса Web

Вас просят добавить эндпоинт в существующий API, и вы застреваете на первом же решении: POST /users/42/deactivate или PATCH /users/42? Работают оба варианта. Оба дойдут до продакшна. Но один покажется следующему разработчику очевидным, а второй начнёт спор на ревью. REST не спецификация, которой можно соответствовать, это набор соглашений: зная их, посторонний человек угадает устройство вашего API с первой попытки.

Представьте картотечный шкаф. У каждого ящика и каждой папки есть адрес, и адрес никогда не говорит, что вы собираетесь там делать. Действие это отдельное решение: прочитать, заменить, выбросить. REST делит API точно так же. URL это адрес вещи. HTTP-метод это глагол. ...