# 幂等密钥

> 幂等密钥是客户端随请求发送的自选标识符，使超时或错误后的重试返回原始结果，而不会重复发送消息。

网络可能在服务器已经执行、客户端尚未收到结果时中断。没有幂等机制，超时后的安全选择是什么也不做，不安全选择则是重试并发送重复消息。有了密钥，客户端可以放心重试：服务器识别密钥，重放首次响应，不再发送新消息。

密钥应从你自己的业务标识符（订单号、用户和尝试次数）派生，使不同进程的重试正确相遇；重试时必须重复使用，不能重新生成。

在 SMSMeteor：任何 POST 都接受 `Idempotency-Key`；24 小时内相同密钥和相同有效载荷返回原响应，并带 `Idempotent-Replayed: true`；有效载荷不同则返回 `409 idempotency_conflict`。

相关术语：[REST API（SMS）](https://smsmeteor.com/zh/glossary/rest-api)、[指数退避](https://smsmeteor.com/zh/glossary/exponential-backoff)、[批量端点](https://smsmeteor.com/zh/glossary/batch-endpoint)

---
来源：[HTML 页面](https://smsmeteor.com/zh/glossary/idempotency-key)。由 SMSMeteor 使用与页面相同的数据生成。[全站摘要](https://smsmeteor.com/zh/llms.txt)