差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
get_put_post [2026/10/12 15:12] – get_put_post 页面补充 DokuWiki 正文:概述与速查表 张叶安get_put_post [2026/10/12 15:12] (当前版本) – get_put_post 页面补充 DokuWiki 正文:用法选择、请求示例与注意事项 张叶安
行 75: 行 75:
 - 认为 POST 一定创建资源:它只是「非幂等提交」的通用语义 - 认为 POST 一定创建资源:它只是「非幂等提交」的通用语义
 ``` ```
 +
 +===== 什么时候用哪个 =====
 +
 +  * 只想取数据 → **GET**
 +  * 新建一条记录,还不知道它的 URL → **POST** 到集合
 +  * 已知完整 URL,要整体覆盖 → **PUT**
 +  * 只想改其中几个字段 → **PATCH**(不属于这三者)
 +
 +===== 请求示例 =====
 +
 +<code http>
 +GET /users/1 HTTP/1.1
 +Host: api.example.com
 +
 +POST /users HTTP/1.1
 +Host: api.example.com
 +Content-Type: application/json
 +
 +{"name":"张三","email":"a@example.com"}
 +
 +PUT /users/1 HTTP/1.1
 +Host: api.example.com
 +Content-Type: application/json
 +
 +{"id":1,"name":"张三","email":"b@example.com"}
 +</code>
 +
 +<code js>
 +// 三个方法对应三种语义
 +await fetch("/users/1");                                                  // GET:读
 +await fetch("/users",   { method: "POST", body: JSON.stringify(user) });   // 创建,ID 由服务端生成
 +await fetch("/users/1", { method: "PUT",  body: JSON.stringify(user) });   // 整体替换,ID 由客户端指定
 +</code>
 +
 +===== 注意事项 =====
 +
 +  * 用 GET 做增删改很危险:爬虫抓取、浏览器预取、网络重试都可能误触发。
 +  * PUT 若只传部分字段,未传字段会被清空(整体替换语义),局部更新要用 PATCH。
 +  * POST 在网络重试下可能重复创建,通常需要幂等键(''Idempotency-Key'')去重。
 +  * 幂等的定义是「执行一次和执行多次,服务端最终状态相同」,指的是**状态**,不是响应码。
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • get_put_post.1791789155.txt.gz
  • 最后更改: 2026/10/12 15:12
  • 由 张叶安