安全且等效的方法

如果一个方法不会改变服务器状态，那么它就是安全的：例如 GET、HEAD 和 OPTIONS 请求。如果多次发出相同的请求与发出一次相同的请求效果相同，那么该方法就是幂等的：例如 GET、HEAD、OPTIONS、PUT 和 DELETE 请求。所有安全的方法都是幂等的；反之则不然，因为 DELETE 请求会改变服务器状态，但它仍然是幂等的。

工作原理

正是这些特性使得自动重试成为可能。代理、浏览器或 HTTP 库可以在超时后自动重试幂等请求，而无需事先询问，因为重复请求不会使情况变得更糟。POST 和 PATCH 请求既不安全也不幂等，因此不会自动重试——这也是为什么需要 Idempotency-Key 请求头的原因，它赋予了 POST 请求本身所缺乏的幂等特性。

误解

幂等性意味着"returns the same response" 。它指的是对服务器产生相同的*效果*。即使第一次 DELETE 操作返回 204，第二次返回 404，但对同一资源的第二次 DELETE 操作仍然是幂等的：最终状态——资源被删除——是相同的。

点击这里试试

`GET /starfleet/v1/tribbles`是一种刻意设计的反模式：每次读取该 GET 请求时，请求数量都会翻倍。它最清晰地展示了"safe"机制究竟要保护你免受什么侵害。

相关内容

• 测试幂等密钥和安全重试
• What a REST API is

资料来源

• HTTP semantics — RFC 9110
• HTTP caching — RFC 9111

其他术语

• REST API — 将系统建模为可寻址资源的 API，可通过标准 HTTP 方法进行操作。
• ETag — 用于表示形式的不透明版本标识符，用于避免重新发送该表示形式并检测冲突的写入。
• PUT 与 PATCH — PUT 参数将资源替换为您发送的表示形式；PATCH 参数将一组更改应用到该资源。
• 重试后 — 响应头告诉客户端在重试之前要等待多长时间，以秒或日期为单位。
• 指数退避 — 一种重试策略，其中每次等待时间都比上一次更长，并添加随机性，以防止客户端同步重试。
• 请求超时 — 客户端在放弃请求之前等待响应的最长时间。

阅读英文版

所有术语 · 测试技巧 · 全部 39 个模拟 REST API

最后更新时间 2026年10月16日