查询HTTP请求方法的定义、语义、幂等性与安全性,辅助Web开发与API设计。
工具用的顺手吗?
你的反馈能帮助我们做得更好
概览
了解工具能解决的问题、计算或处理逻辑,以及数据边界。
页面当前列出 14 条记录,字段为“方法、名称、描述、附加说明”。其中包含 RFC 9110 定义的 GET、HEAD、POST、PUT、DELETE、CONNECT、OPTIONS、TRACE,也包含 PATCH、WebDAV 的 COPY 与 MOVE,以及 LINK、UNLINK、WRAPPED。它是一份可搜索、排序和隐藏列的静态速查表,不会向服务器发送这些请求,也不会检测某个接口真正支持哪些方法。
搜索框会对所有可见数据做包含匹配;点击任一列标题可切换排序,列菜单可暂时隐藏字段。记录多于当前页容量时可翻页。表格的描述是简化提示,API 设计与故障排查仍应回到对应 RFC、IANA 注册表和目标服务文档。
“安全”描述客户端请求该方法时不期望改变服务器状态的语义;“幂等”描述多次发送相同请求,对服务器产生的预期效果应与发送一次相同。按照 IANA 注册表,GET、HEAD、OPTIONS、TRACE 同时标为安全且幂等;PUT、DELETE、COPY、MOVE、LINK、UNLINK 不安全但幂等;POST、PATCH、CONNECT 不安全且不保证幂等。
幂等不等于每次响应完全相同,也不等于没有日志、计费或审计等附带影响。安全也不是权限或加密保证:GET 仍可能泄露数据,TRACE 在某些部署中会被禁用,具体开放方法取决于服务端策略。
指南
按步骤完成操作,并通过示例核对输入与结果。
在搜索框输入PATCH、COPY等完整名称,或输入描述中的关键词。搜索结果为空时先清除其他筛选,再检查拼写。
先读“描述”理解表内摘要,再看“附加说明”寻找 RFC 线索。点击列标题可以按方法名或文字排序,列菜单可保留当前任务需要的字段。
GET 到 TRACE 的八个核心方法以 RFC 9110 为当前语义依据;PATCH 有独立规范;COPY、MOVE 属于 WebDAV。不能因为名称出现在表中就假定所有 HTTP 服务都实现它。
最终以接口文档、响应中的Allow字段、服务端路由和权限策略为准。表格只提供概念线索,不执行 OPTIONS 探测。
| 方法 | 规范语义重点 | 安全 | 幂等 | 常见误解 |
|---|---|---|---|---|
| GET | 请求目标资源的当前表示 | 是 | 是 | “安全”不代表响应内容不敏感。 |
| POST | 让目标资源按自身语义处理请求内容 | 否 | 否 | 不只用于“新建”,语义由目标资源决定。 |
| PUT | 用请求内容创建或替换目标资源的状态 | 否 | 是 | 幂等不保证每次状态码相同。 |
| PATCH | 对目标资源应用一组部分修改 | 否 | 否 | 具体补丁格式可设计成幂等,但方法注册属性仍是不保证幂等。 |
例如,把同一份完整用户表示反复 PUT 到固定 URI,预期最终状态相同;把“余额增加 10”作为 PATCH 重复提交,则可能产生累计效果。是否可重试还要结合条件请求、幂等键与业务实现。
场景
查看这项工具在不同工作与生活流程中的用法。
API 设计者先按资源语义筛选候选方法,再核对安全性、幂等性与缓存条件,避免把所有写操作都笼统放进 POST。
开发与运维人员对照方法的幂等属性,识别超时后可自动重试的候选请求;真正启用重试前仍需检查业务副作用。
安全人员可搜索 CONNECT、TRACE 或 WebDAV 方法,作为配置核对清单的一部分;表中存在记录并不代表目标服务器已经开放。
问答
集中解答高频疑问与容易混淆的问题。
通常是 PATCH。PUT 的语义是创建或替换目标资源状态,PATCH 则应用部分修改;实际请求体格式、并发控制和字段规则由接口规范决定。
幂等关注服务器的预期最终效果,而不是响应码必须相同。第一次删除资源、第二次发现资源不存在,最终资源都处于“不存在”状态。
不一定。OPTIONS 用于获取目标资源或服务器的通信选项,但响应内容受实现和权限影响;Allow也只代表服务端声明,仍需结合接口文档。
不是。当前 IANA 注册表把 LINK、UNLINK 指向早期 RFC 2068,而 COPY、MOVE 才由 WebDAV RFC 4918 定义;截至核验日期,WRAPPED 不在 IANA HTTP 方法注册表中。
须知
使用前了解适用范围、结果限制与必要提醒。
页面数据是 14 条静态摘要,不是 IANA 注册表的完整镜像,也不承诺随新 RFC 自动同步。
可先搜索一个方法读摘要,再用附加说明定位规范,最后回到目标 API 文档确认真实行为。
推荐
查找相关工具、专题与可用的 API 能力。