Idempotency-key нужен для предотвращения повторного выполнения одной и той же операции на уровне инфраструктуры, особенно в распределённых системах и при сетевых сбоях.

Даже если в бизнес-логике есть проверка на дубликаты, idempotency-key обеспечивает:

Гарантию единственного выполнения запроса независимо от повторных попыток клиента (например, при таймаутах или повторных отправках).
Уменьшение нагрузки на бизнес-логику и базу данных, так как запрос с тем же ключом можно быстро распознать и вернуть сохранённый результат без повторного выполнения.
Устойчивость к сетевым ошибкам и повторным вызовам, что важно для финансовых операций, заказов и других критичных процессов.

Пример: клиент отправляет запрос на оплату с idempotency-key. Если запрос повторяется из-за сбоя связи, сервер по ключу понимает, что операция уже выполнена, и не создаёт дубликат транзакции.

Зачем нужен idempotency-key, если у вас всё равно на уровне бизнес-логики идёт проверка?