Как организована идемпотентность у вас?

Идемпотентность — это свойство операции, при котором многократное её выполнение даёт тот же результат, что и однократное.

В Java-приложениях идемпотентность обычно достигается несколькими способами:

• Использование уникальных идентификаторов запросов (idempotency keys). Клиент генерирует уникальный ключ для операции, сервер сохраняет состояние по этому ключу и при повторных запросах с тем же ключом возвращает тот же результат, не выполняя операцию повторно.
• Проектирование операций как идемпотентных на уровне бизнес-логики. Например, операции обновления, которые устанавливают конкретное значение, а не изменяют его относительно текущего.
• Использование транзакций и проверок состояния. Перед выполнением операции проверяется, не была ли она уже выполнена (например, по статусу в базе данных).
• Хранение состояния операций. В базе данных или кэше сохраняется информация о выполненных операциях, чтобы избежать повторного выполнения.

Пример использования idempotency key в REST API:

@PostMapping("/payments")
public ResponseEntity<?> createPayment(@RequestHeader("Idempotency-Key") String key, @RequestBody PaymentRequest request) {
    if (paymentService.existsByIdempotencyKey(key)) {
        return ResponseEntity.ok(paymentService.getByIdempotencyKey(key));
    }
    Payment payment = paymentService.processPayment(request);
    paymentService.saveWithIdempotencyKey(payment, key);
    return ResponseEntity.status(HttpStatus.CREATED).body(payment);
}

Таким образом, повторный запрос с тем же ключом не создаст дубликат операции.