Идемпотентность

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

Каждое входящее сообщение или запрос снабжается уникальным идентификатором (Idempotency Key). Получатель проверяет, обрабатывалось ли сообщение с таким идентификатором ранее. Если да — возвращает сохранённый результат без повторной обработки. Если нет — обрабатывает и запоминает результат. Это позволяет безопасно повторять запросы при сбоях без риска дублирования эффекта.

Идемпотентность — обязательное свойство любого API, связанного с деньгами, инвентарём или документами. Платёжный сервис должен быть идемпотентным: если клиент нажал «оплатить» дважды (или запрос повторился из-за сетевого сбоя), деньги списываются только один раз. Складской сервис должен быть идемпотентным: повторная обработка накладной не создаёт дополнительного расхода.

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