Почему важно продумывать idempotency API-операций?

Question

Клиенты могут повторять запросы из-за таймаутов или ошибок сети. Если операция не идемпотентна, повтор приведёт к дублированию действий. Это особенно опасно для платежей и создания ресурсов. Идемпотентность делает API безопасным при повторах.

YeaHub · Accepted Answer

ОпределениеIdempotency — это свойство операции, при котором повторный вызов даёт тот же результат, что и первый.Почему повторы неизбежныВ распределённых системах невозможно гарантировать, что запрос выполнится ровно один раз.Сетевые таймаутыклиент не получил ответсервер выполнил операциюRetry-механизмына стороне клиентана стороне прокси или балансировщикаОшибки уровня 500клиент не знает, был ли эффектЧем это опасноЕсли операция неидемпотентна, возникают:повторные списаниядублирующие записиповторные события в очередяхТиповые подходыIdempotency keyуникальный ключ запросасохранение результата операцииАтомарные операциипроверка и изменение в одном шагеЕстественная идемпотентностьPUT вместо POSTобновление по ключуПримерPOST /payments
Idempotency-Key: 8f3a...
Сервер возвращает один и тот же результат для повторных запросов с тем же ключом.ВыводИдемпотентность — обязательное свойство надёжных API, особенно при работе с деньгами и внешними системами.