Online Tool Store
Генератор ключей идемпотентности
Генерируйте ключи идемпотентности UUID v4 или v7 в браузере, пакетами до 100, с копированием, экспортом в TXT/CSV и готовыми примерами заголовка, cURL и fetch.
🔒 Этот инструмент работает полностью в вашем браузере. Ваши файлы никогда не загружаются на сервер.
Только буквы, цифры, _ - . · до 32 символов.
Сгенерировано локально в вашем браузере с криптографически стойкой случайностью. Ничего не загружается. Префикс — это просто метка, он не добавляет уникальности или безопасности.
Использование для разработчиков
В примерах используется первый сгенерированный ключ
Отправляйте тот же Idempotency-Key при повторе той же операции; используйте новый ключ для новой операции. Этот инструмент только генерирует ключи — обработку идемпотентности выполняет ваш API. Эндпойнт ниже — это заглушка, а не реальный сервис.
Как работает Генератор ключей идемпотентности
- Выберите тип ключа (UUID v4 или v7) и при желании префикс и размер пакета.
- Скопируйте сгенерированный ключ или экспортируйте пакет в TXT или CSV.
- Отправьте его как заголовок Idempotency-Key; используйте тот же ключ при повторе этой операции и новый ключ для новой операции.
FAQ
Чем помогает этот инструмент?
Он генерирует уникальные ключи (UUID v4 или v7, с необязательным префиксом), которые вы добавляете к запросу API как заголовок Idempotency-Key, чтобы безопасный повтор той же операции не был обработан дважды.
Отправляет ли он данные куда-либо?
Нет. Ключи генерируются в вашем браузере встроенным криптографически стойким генератором случайных чисел, и ничего не загружается на сервер.
Можно ли пользоваться сразу?
Да. Ключ появляется сразу после загрузки страницы. Нажмите «Сгенерировать» для нового или выберите размер пакета, чтобы создать до 100 за раз и скопировать или экспортировать их в TXT или CSV.
Делает ли он мой API идемпотентным?
Нет. Инструмент только создаёт ключи. Ваш API или платёжный провайдер должен реализовать обработку идемпотентности, которая устраняет дубли запросов с одним и тем же ключом.
В чём разница между UUID v4 и UUID v7?
UUID v4 полностью случаен. UUID v7 встраивает метку времени в миллисекундах перед случайными битами, поэтому ключи сортируются примерно по времени создания — полезно, если вы логируете или индексируете ключи идемпотентности, но не требуется для самого заголовка.
Нужно ли повторно использовать тот же ключ при повторе запроса?
Да. Сгенерируйте один ключ перед первой попыткой операции, затем отправляйте тот же ключ при каждом повторе именно этой операции. Новый ключ используйте только тогда, когда начинаете действительно новую операцию.
Можно ли использовать эти ключи со Stripe или другими платёжными API?
Да. И ключи UUID v4, и v7 работают как значение заголовка Idempotency-Key у провайдеров вроде Stripe, Square и большинства REST API, которые поддерживают идемпотентную запись.
Как мы выглядим в сравнении
| Возможность | Online Tool Store | Написанный вручную фрагмент UUID | Генерация ключей на сервере |
|---|---|---|---|
| Работает офлайн в браузере | ✓ | ✓ | ✗ |
| UUID v4 и v7 | ✓ | Зависит | Зависит |
| Пакетная генерация + экспорт в TXT/CSV | ✓ | ✗ | Иногда |
| Готовые примеры заголовка, cURL и fetch | ✓ | ✗ | ✗ |
Используйте это для быстрого приватного ключа или пакета, пока настраиваете идемпотентные вызовы API; перенесите генерацию ключей на сервер, когда она станет частью вашего рабочего процесса в продакшене.