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

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

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

Где применяется?

Концепция идемпотентности критически важна при проектировании API, особенно в распределенных системах и микросервисной архитектуре. Она позволяет безопасно повторять запросы при сетевых сбоях, таймаутах или ошибках на стороне клиента, не опасаясь нежелательных побочных эффектов (например, двойного списания денег).

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

• GET — идемпотентен. Получение данных не меняет состояние ресурса.
• PUT — идемпотентен. Установка конкретного значения ресурса. Повторный запрос с теми же данными не изменит состояние.
• DELETE — идемпотентен. Удаление ресурса. Повторное удаление того же ресурса (если он уже удален) обычно возвращает ошибку, но состояние системы (ресурс отсутствует) не меняется.
• POST — не идемпотентен. Создание нового ресурса. Каждый запрос создает новый ресурс.
• PATCH — может быть как идемпотентным, так и нет, в зависимости от реализации. Например, операция "увеличить счетчик на 1" неидемпотентна.

Практический пример на JavaScript (имитация API)

// Идемпотентный PUT-запрос
async function updateUser(id, data) {
  const response = await fetch(`/api/users/${id}`, {
    method: 'PUT',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(data)
  });
  return response.json();
}

// Вызовем 3 раза с одинаковыми данными
await updateUser(1, { name: 'Alice' });
await updateUser(1, { name: 'Alice' });
await updateUser(1, { name: 'Alice' });
// Результат: имя пользователя с id=1 всегда будет 'Alice'

Вывод

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