常用方法(REST / API)

方法语义幂等请求体典型用途
GET获取资源通常无查询列表、详情;参数在 URL query
POST提交/创建常有创建资源、表单提交、非幂等操作
PUT整体替换常有用 body 完整替换指定 URI 资源
PATCH部分更新否*常有只更新部分字段(JSON Patch 等)
DELETE删除资源可选删除指定 URI;重复删除常返回 404/204
HEAD同 GET 但无 body检查资源是否存在、取响应头
OPTIONS查询支持的方法CORS 预检;发现 Allow 头

* PATCH 是否幂等取决于具体语义与实现。

其他方法

方法说明
CONNECT建立隧道,多用于 HTTPS 代理
TRACE回显请求,调试用;生产环境常禁用

REST 风格与状态码搭配(参考)

操作推荐方法成功状态码
查询GET200
创建POST201 + Location
全量更新PUT200 / 204
部分更新PATCH200 / 204
删除DELETE204 / 200

工具说明

幂等:同一请求执行多次,资源状态与执行一次相同(GET、PUT、DELETE 通常幂等;POST 创建两次会得到两个资源)。

常见误区

用 GET 做删除或改数据(不安全、可被缓存/预取);用 POST 做一切;PUT 与 PATCH 混用——PUT 应传完整资源,PATCH 只传变更字段。