差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 | |||
| 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: | ||
| + | |||
| + | {" | ||
| + | |||
| + | PUT /users/1 HTTP/1.1 | ||
| + | Host: api.example.com | ||
| + | Content-Type: | ||
| + | |||
| + | {" | ||
| + | </ | ||
| + | |||
| + | <code js> | ||
| + | // 三个方法对应三种语义 | ||
| + | await fetch("/ | ||
| + | await fetch("/ | ||
| + | await fetch("/ | ||
| + | </ | ||
| + | |||
| + | ===== 注意事项 ===== | ||
| + | |||
| + | * 用 GET 做增删改很危险:爬虫抓取、浏览器预取、网络重试都可能误触发。 | ||
| + | * PUT 若只传部分字段,未传字段会被清空(整体替换语义),局部更新要用 PATCH。 | ||
| + | * POST 在网络重试下可能重复创建,通常需要幂等键('' | ||
| + | * 幂等的定义是「执行一次和执行多次,服务端最终状态相同」,指的是**状态**,不是响应码。 | ||