Каково предназначение HTTP-метода PUT в RESTful API?

HTTP-метод PUT в RESTful API используется для создания или замены ресурса по указанному URI. Основные характеристики PUT:

• Идемпотентность: повторные запросы с одинаковыми данными не изменяют результат после первого запроса.
• Создание или обновление: если ресурс существует, он обновляется; если нет — создаётся.
• Полное обновление: обычно PUT отправляет полное представление ресурса, заменяя существующий.

Пример: если у вас есть ресурс пользователя по адресу /users/123, вызов PUT с новым JSON-объектом заменит данные пользователя 123 на новые.

В отличие от POST, который обычно используется для создания ресурсов с сервером, генерирующим идентификатор, PUT явно указывает URI ресурса.