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

Идемпотентность — это свойство операции, при котором её многократное выполнение приводит к тому же состоянию системы, что и однократное. Это не значит, что операция не меняет данные: важно, чтобы повторный вызов не создавал дополнительных эффектов. Например, установка значения поля в 10 идемпотентна, а инкремент на 1 — нет.

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

• HTTP-методы: GET, PUT, DELETE считаются идемпотентными, POST — нет.
• Платёжные и банковские API: повторный запрос на списание не должен списывать деньги дважды.
• Очереди и брокеры сообщений: при доставке at-least-once сообщение может прийти несколько раз.
• Микросервисы и распределённые системы: retry при таймаутах и сетевых сбоях.
• Инфраструктура как код: повторное применение конфигурации даёт тот же результат.

Пример на практике

Клиент отправляет запрос на создание платежа, но не получает ответ из-за таймаута и повторяет запрос. Чтобы не создать два платежа, сервер использует ключ идемпотентности.

POST /payments
Idempotency-Key: 8f14e45f-ea0b-4c1a-9c1e-2b7d1a6f9c33
{ "amount": 100, "currency": "USD" }

// Сервер сохраняет ключ и результат.
// Повторный запрос с тем же ключом вернёт тот же ответ,
// не создавая новый платёж.

Как реализуют

1. Клиент генерирует уникальный ключ идемпотентности для операции.
2. Сервер сохраняет ключ и результат в БД или Redis с TTL.
3. При повторном запросе сервер находит ключ и возвращает сохранённый результат.
4. Для очередей используют дедупликацию по message id.

Важно различать идемпотентность и безопасность: безопасные методы (GET, HEAD) не меняют состояние, а идемпотентные могут менять, но повторно — без дополнительного эффекта.

Идемпотентность стоит применять везде, где возможны повторные вызовы: в публичных API, платёжных системах, очередях и распределённых сервисах. Это делает систему устойчивой к сбоям сети и повторным попыткам клиентов.