"""Логика идемпотентности для POST запросов.""" import hashlib import json from .errors import ApiError, bad_request def get_request_hash(data: dict) -> str: """Хеш тела запроса, независимый от порядка ключей.""" return hashlib.sha256(json.dumps(data, sort_keys=True).encode("utf-8")).hexdigest() def check_and_lock(conn, user_id: str, method: str, path: str, key: str, req_hash: str): """ Блокирует ключ идемпотентности через advisory lock в PostgreSQL. """ if not key: raise bad_request("Missing Idempotency-Key") if not isinstance(key, str) or not (1 <= len(key) <= 128): raise bad_request("Invalid Idempotency-Key format") # Берем блокировку на уровне БД по хешу ключа. lock_id = f"{user_id}:{method}:{path}:{key}" conn.execute("SELECT pg_advisory_xact_lock(hashtext(%s))", (lock_id,)) # Проверяем, есть ли уже такой ключ row = conn.execute(""" SELECT request_hash, status_code, response_body FROM idempotency_keys WHERE user_id = %s AND method = %s AND path = %s AND key = %s """, (user_id, method, path, key)).fetchone() if row: # Ключ уже существует if row["request_hash"] != req_hash: raise ApiError(409, "conflict", "Idempotency-Key conflict: body differs") # Если запрос уже был успешно обработан, возвращаем сохраненный ответ if row["status_code"] is not None and row["response_body"] is not None: return False, json.loads(row["response_body"]) # Если status_code пустой, значит первая транзакция упала. Разрешаем перезапись. return True, None return True, None def save_result(conn, user_id: str, method: str, path: str, key: str, req_hash: str, status_code: int, response_body: dict): """Сохраняет результат выполнения запроса для будущих повторных вызовов.""" conn.execute(""" INSERT INTO idempotency_keys (user_id, method, path, key, request_hash, status_code, response_body) VALUES (%s, %s, %s, %s, %s, %s, %s) ON CONFLICT (user_id, method, path, key) DO UPDATE SET status_code = EXCLUDED.status_code, response_body = EXCLUDED.response_body """, (user_id, method, path, key, req_hash, status_code, json.dumps(response_body))) def cleanup(conn, ttl_seconds: int): """Оппортунистическая очистка старых ключей (через подзапрос, т.к. DELETE LIMIT в PG нет).""" conn.execute(""" DELETE FROM idempotency_keys WHERE (user_id, method, path, key) IN ( SELECT user_id, method, path, key FROM idempotency_keys WHERE created_at < now() - make_interval(secs => %s) LIMIT 100 ) """, (ttl_seconds,))