幂等键生成器
为可重试 API 请求创建幂等键。使用浏览器 Web Crypto 本地生成,不会发送请求或管理幂等处理。
使用步骤
如何使用
- 选择 UUID v4 或 UUID v7、可选前缀和批量数量。
- 本地生成键,并复制 HTTP、cURL 或 JavaScript fetch 示例。
- 需要保存时下载 TXT 或 CSV。相同逻辑操作的重试应复用原键,新操作使用新键。
用于幂等 API 请求
将一个生成值作为一个逻辑操作的 Idempotency-Key。重试时复用原键,新操作使用新键。API 要求可能规定其他格式或前缀。
本地生成 UUID
UUID v4 使用安全随机字节,UUID v7 结合当前毫秒时间戳和安全随机位。必须支持 Web Crypto,不会回退到 Math.random。工具只生成标识符,不发送请求、不存储键,也不保证绝对唯一。
与通用 UUID 工具的边界
本页针对幂等请求应用和配套示例;通用 UUID 请使用 UUID Generator。
常见问题
你可能还想知道
重试时要生成新键吗?
不要。同一逻辑操作的重试应复用原键;新操作才生成新键。
会调用我的 API 吗?
不会,只在本地生成文本,示例使用 api.example.com 占位地址。
前缀是 UUID 的一部分吗?
不是,但它会加入传输的键,完整值可能不是裸 UUID,必须符合你的 API 合同。
能保证唯一吗?
不能保证绝对唯一。服务仍需负责自己的幂等策略。