Ключи идемпотентности — как избежать дублирования операций (например, двойной оплаты) при потере соединения?

Question

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

YeaHub · Accepted Answer

Идемпотентность гарантирует, что повторный запрос с теми же параметрами не вызовет побочных эффектов.Как работают ключи идемпотентности:Генерация ключаКлиент создает уникальный UUID для операцииКлюч привязывается к конкретной бизнес-операцииСохраняется на клиенте для повторной отправкиОбработка на сервереСервер проверяет наличие ключа в хранилищеЕсли ключ новый — выполняется операцияЕсли ключ уже использован — возвращается кэшированный ответПример реализации:class PaymentController {
    public function processPayment(Request $request) {
        $idempotencyKey = $request->header('Idempotency-Key');
        
        // Проверка в Redis
        $cacheKey = "idempotency:{$idempotencyKey}";
        if ($result = Redis::get($cacheKey)) {
            return json_decode($result);
        }
        
        // Выполнение платежа
        $paymentResult = $this->process($request);
        
        // Сохранение результата
        Redis::setex($cacheKey, 3600, json_encode($paymentResult));
        
        return $paymentResult;
    }
}Типичное использование:Финансовые операции (платежи, переводы)Создание заказовКритичные изменения данных