HTTP
Methods & Status API Reference
HTTP 协议的请求方法与状态码语义,定义客户端与服务器交互规范。
By EZ4Code Team
HTTP Semantics
HTTP 请求方法(动词)与状态码,表示操作意图与响应结果。
GET <URL>请求获取指定资源,不应有副作用,是幂等的。
Returns: 服务器返回资源表示,通常 200 OK
POST <URL>提交数据创建新资源,非幂等(多次提交可能创建多个资源)。
Returns: 通常返回 201 Created 与新资源 URI
PUT <URL>用请求体替换目标资源,是幂等的(相同请求结果一致)。
Returns: 通常 200 OK 或 204 No Content
DELETE <URL>删除指定资源,是幂等的。
Returns: 通常 200 OK、202 Accepted 或 204 No Content
PATCH <URL>对资源应用部分修改,非幂等(取决于实现)。
Returns: 通常 200 OK 或 204 No Content
HEAD <URL>与 GET 相同但只返回响应头,不返回响应体。
Returns: 只含响应头,无响应体
OPTIONS <URL>查询服务器支持的方法或通信选项,常用于 CORS 预检。
Returns: 响应头含 Allow 或 Access-Control-Allow-* 字段
200 OK请求成功。GET 返回资源,POST 返回创建结果,PUT/PATCH 返回更新结果。
Returns: 成功状态码,响应体含请求结果
301 Moved Permanently资源已永久移动到新 URI,后续请求应使用新地址。
Returns: 重定向状态码,客户端应跟随 Location
404 Not Found服务器找不到请求的资源,常用于资源不存在或路径错误。
Returns: 客户端错误状态码,资源不存在