Как работает идемпотентность под капотом — где и как хранятся ключи, с чем сравнивается запрос?

Техническая реализация идемпотентности требует тщательного проектирования хранения и сравнения запросов.

Хранение ключей:

1. Выбор хранилища

   • Redis: высокая производительность, TTL

   • Memcached: простота, автоматическое вытеснение

   • База данных: надежность, персистентность

2. Структура ключа

   • idempotency:{user_id}:{key_hash}

   • Включает идентификатор клиента для изоляции

   • Хеш от параметров запроса для точности

Процесс сравнения:

1. Извлечение ключа из заголовка запроса

2. Создание fingerprint запроса:

   $requestFingerprint = md5(
       $method . ':' . 
       $path . ':' . 
       json_encode($params) . ':' . 
       $idempotencyKey
   );

3. Поиск в хранилище по fingerprint

Полная реализация:

class IdempotencyService {
    public function handle(Request $request, callable $operation) {
        $key = $request->header('Idempotency-Key');
        $fingerprint = $this->createRequestFingerprint($request, $key);
        
        // Проверка в кэше
        if ($cached = Redis::get("idempotency:{$fingerprint}")) {
            return unserialize($cached);
        }
        
        // Выполнение операции
        $result = $operation();
        
        // Сохранение с TTL
        Redis::setex(
            "idempotency:{$fingerprint}", 
            24 * 3600, // 24 часа
            serialize($result)
        );
        
        return $result;
    }
}

Нюансы реализации:

• TTL должен покрывать время возможного повтора

• Учет разных пользователей

• Очистка устаревших ключей