Can you explain the concept of idempotency in API methods or functions?

Idempotency is a property of a method or function whereby multiple executions with the same input data do not change the state of the system after the first call.

In simpler terms, if you call an idempotent method several times in a row with the same parameters, the result will be the same as if you called it once.

For example, the HTTP PUT method is usually idempotent: if you send a request to update a resource with the same data multiple times, the resource's state will not change after the first update.

An example of an idempotent method:

public void setUserName(User user, String name) {
    user.setName(name); // regardless of the number of calls, the name will be the same
}

In contrast, a method that increments a counter is not idempotent, as each call changes the state.