Что такое идемпотентность?

Идемпотентность — это свойство операции, при котором многократное выполнение одной и той же операции с одинаковыми входными данными приводит к одному и тому же результату, как если бы операция была выполнена один раз.

В контексте веб-сервисов или API это означает, что повторный запрос не изменит состояние системы дополнительно.

Пример идемпотентного HTTP-метода — PUT, который обновляет ресурс. Если отправить один и тот же PUT-запрос несколько раз, результат будет одинаковым.

В Go идемпотентность можно обеспечить, например, проверяя наличие записи перед вставкой:

func CreateUser(id string, data UserData) error {
    if userExists(id) {
        return nil // уже создано, операция идемпотентна
    }
    return insertUser(id, data)
}

Таким образом, повторный вызов CreateUser с одним и тем же id не приведёт к ошибке или дублированию.