你需要了解的 http status code

intro

现在前后端分离的开发模式越来越流行，后端负责开发对应的 api，前端只需要
关注前端页面的数据展示和前端逻辑即可。

对于前后端分离这种开发模式，我个人还是比较喜欢的，因为这样可以让更专业的人做更专业的事情，后端专注于做 api 的开发设计，前端专注于数据的展示，页面的样式。

这样前后端需要就某些信息达成一些共识，比如说常用的 http 方法, 常用的 http 状态码等

http method 较为简单，我们常用的习惯如下：

一般查询我们都会使用 get 方法，
创建新的记录使用 post 方法
更新已有数据使用 put 方法
更新已有数据部分属性使用 patch 方法
删除已有数据使用 delete 方法

下面来详细介绍一下常用的 http 状态码

1xx

1xx 状态码一般是一个请求的中间状态，一般是信息提示，请求协商

100 continue，请求未结束，应该继续请求

101 switching protocol，协议转换，在使用 web socket 的时候就会遇到，下面是一个示例，响应会有一个 connection: upgrade 的请求头，upgrade 会指定要使用的协议名称

2xx

2xx 一般表示请求处理成功

200 ok，请求处理成功

201 created，请求处理成功，并且新资源已经创建

202 accepted，请求已经接受，正在处理，尚未处理完成

204 no content，响应内容为空，在 asp.net core 中返回一个 json(null) 的时候就会是一个 nocontent 的结果

3xx

3xx 一般表示重定向

301 moved permanently 永久重定向

302 found 临时重定向

307 temporary redirect 临时重定向请求

308 permanent redirect 永久重定向请求

这几个重定向的区别：
301、302 只支持 get 请求，如果是 post 请求，重定向后会使用 get 请求且 body 数据会丢失

307、308 支持 post 请求，在 post 重定向的时候会带上原来请求的 body 再请求新的地址，body 数据不会丢失

302、307 是临时重定向，
301、308 是永久重定向，是允许缓存的，浏览器可以缓存

304 not modified，资源未发生修改，可以直接使用浏览器本地缓存

this is the response code to an if-modified-since or if-none-match header, where the url has not been modified since the specified date.

4xx

4xx 一般表示客户端请求错误

400 badrequest，错误请求，一般用来表示请求参数异常，比如请求的某一个参数不能为空，但实际请求是空

401 unauthorized，未授权，资源需要授权或登录，而用户没有登录或者没有提供访问所需的 token 等

403 forbidden，禁止访问，当前用户没有权限访问资源，如需要admin角色的用户，但是请求的用户没有这个角色

404 notfound，未找到资源，资源不存在

405 method not allowed，不允许的方法调用，资源不支持的请求方法，比如资源只允许 get 请求，但是实际请求使用了 post 或 delete 方法

406 not acceptable，请求的资源客户端不支持处理，比如客户端希望获取 xml 的响应，但是服务器端只支持 json 响应

408 request timeout, 请求处理超时

409 conflict，请求资源冲突，常发生在 put 更新资源信息时发生，比如更新时指定资源的 etag，但是put请求时，资源的 etag 已经发生变化

410 gone，请求资源在源服务器上不再可用

411 length required，请求需要携带 content-length 请求头

412 precondition failed，请求预检失败，请求的某些参数不符合条件

the pre condition given in the request evaluated to false by the server.

413 payload too large，请求的参数太大，请求的 body 过大，服务器拒绝处理

414 uri too long，请求的 uri 地址太长，服务器拒绝处理

415 unsupported media type，不支持的媒体类型或不支持的编码，比如服务器只支持处理 json 请求，但是请求是 xml 格式

the 415 (unsupported media type) status code indicates that the
origin server is refusing to service the request because the payload
is in a format not supported by this method on the target resource.
the format problem might be due to the request's indicated
content-type or content-encoding, or as a result of inspecting the
data directly.

5xx

5xx 一般表示服务端错误

500 internal server error，服务器内部错误

501 not implemented 服务器不支持需要处理请求的功能，比如图片压缩等处理

502 bad gateway 反向代理或网关找不到处理请求的服务器

503 service unavailable 服务不可用

504 gateway timeout 网关超时

505 http version not supported，不支持的 http 版本，服务器不支持或拒绝处理这个 http 版本的请求

reference

• https://developer.mozilla.org/en-us/docs/web/http/status