搜索与 AI
幂等性是什么？
Idempotency
幂等性（Idempotency）是相同请求重复执行时，对服务器产生的预期效果与执行一次相同的性质。它不要求每次响应文字或状态码完全一致，也不代表请求一定成功。
Idempotency key幂等键
幂等键用来识别同一项操作的重试。只有服务端支持并按约定处理相同键值、参数与保存期限时，客户端重发才有对应的去重保障；随意加一个字段不会自动生效。
为什么智能体需要安全的重试方式
订位请求发出后超时，可能是后端尚未处理，也可能是订单已创建、只有响应丢失。立即再发一次创建请求，可能造成两笔订位。
产品可以提供查询既有状态的方式，并在支持的操作中使用幂等键。智能体应按服务约定查询或重试，不能把“没有收到响应”直接当成“没有执行”。
HTTP 方法与业务操作要一起看
RFC 9110 将 PUT、DELETE 与安全方法定义为幂等方法；使用 POST 创建订单，并不会因为采用 HTTP 就自动具备相同保障。像 Stripe 的 POST API，则另外提供幂等键机制。
幂等性处理的是重复操作的效果；授权、参数是否符合用户要求，以及结果能否被确认，仍需另外验证。
参考资料
最近查核：