Глоссарий FazerCards
Idempotency-ключ
Уникальное значение от клиента (заголовок `Idempotency-Key`), по которому сервер считает повторный POST тем же запросом — спасает от дублей заказов при ретраях.
Idempotency-ключ — это уникальная строка, которую клиент прикрепляет к write-запросу. Если тот же ключ приходит дважды (например, первый ответ потерялся в сети), сервер возвращает результат первой операции, а не создаёт второй заказ. Обязателен для POST /order в боевой интеграции; обычно используют UUIDv4. FazerCards хранит соответствие ключ→результат окно ≥24ч, чтобы ретраи в этом окне были безопасны.
Главные факты
- Свежий UUID на каждый логический заказ, а не на каждый ретрай.
- Тот же ключ с другим телом — это ошибка.
- Вместе с дедупликацией webhook'ов исключает двойное списание у игрока.