Что такое идемпотентный метод в REST API

Идемпотентный метод в REST API — это метод, при котором повторные идентичные запросы к серверу имеют тот же эффект, что и первый запрос. Он не изменяет состояние системы после первого выполнения.

Примеры идемпотентных методов:

• GET — получение данных (не изменяет состояние)
• PUT — обновление ресурса (повторный запрос с тем же телом не меняет результат)
• DELETE — удаление ресурса (после первого удаления ресурса его уже нет)

Неидемпотентный пример:
POST — создание ресурса (каждый запрос может создать новый объект).

// PUT-запрос (идемпотентный)  
@PutMapping("/users/{id}")  
public User updateUser(@PathVariable Long id, @RequestBody User user) {  
    return userService.update(id, user); // Повторный вызов не изменит результат  
}