Загрузка…
Короткая голосовая сессия: один вопрос, один уточняющий вопрос, затем мгновенный фидбек — до 5 минут.
Client отправляет уникальный idempotency key вместе с operation, а server сохраняет этот key и результат первой обработки. Если приходит retry с тем же key, server возвращает исходный результат вместо повторного выполнения business operation.
Idempotency особенно важна, когда client может повторить request из-за timeout, network failure или временной потери соединения. Без idempotency retry payment request может привести к двум списаниям или созданию двух orders.
Обычно client отправляет уникальный idempotency key:
POST /payments
Idempotency-Key: 8b7f2a1c-...Server сохраняет этот key вместе с информацией об operation и её результатом. Например, таблица может содержать key, user_id, request_hash, status и идентификатор созданного resource.
На уровне database необходимо обеспечить uniqueness. Если приходит request с уже существующим key и operation завершена, server возвращает сохранённый result. Если operation ещё выполняется, нужно определить отдельную policy: например, вернуть conflict или дождаться завершения первой обработки.
Также важно связывать key с request payload. Если тот же key используется с другим payload, server должен отклонить request, а не считать его тем же самым operation.
В distributed system особенно важна atomicity. Нужно гарантировать, что два concurrent requests с одинаковым key не смогут одновременно выполнить business operation. Для этого используются database constraints, transactions и корректные state transitions.
Idempotency не означает, что request никогда не может завершиться ошибкой. Это гарантия на уровне business operation: повторная обработка одного и того же logical request не должна создавать дополнительный побочный эффект.