前言
最近在整理App跟后端接口设计方案APP客户端开发对后端API设计的初探的时候提到了HTTP状态码,索性这里做一个汇总。
HTTP状态码->HTTP Status Code
HTTP状态码(英语:HTTP Status Code)是用以表示网页服务器超文本传输协议响应状态的3位数字代码,分为五类:
-
1开头:(临时响应)消息状态码
-
2开头:成功状态码
-
3开头:重定向状态码
-
4开头:请求错误状态码
-
5开头:服务端错误状态码
一.常见的状态码:
HTTP: Status 200 – 服务器成功返回网页
HTTP: Status 404 – 请求的网页不存在
HTTP: Status 503 – 服务不可用
二. HTTP: Status 1XX (临时响应)消息状态码
这一类型的状态码,代表请求已被接受,需要继续处理。这类响应是临时响应,只包含状态行和某些可选的响应头信息,并以空行结束。 。
HTTP: Status 100 (继续)
# 描述: 请求者应当继续提出请求。 服务器返回此代码表示已收到请求的第一部分,正在等待其余部分。
HTTP: Status 101 (切换协议)
# 描述: 请求者已要求服务器切换协议,服务器已确认并准备切换。
三. HTTP: Status 2XX (成功)
这一类型的状态码,代表请求已成功被服务器接收、理解、并接受。
HTTP Status 200 (成功)
# 描述: 服务器已成功处理了请求。 通常,这表示服务器提供了请求的网页。
HTTP Status 201 (已创建)
# 描述: 请求成功并且服务器创建了新的资源。
HTTP Status 202 (已接受)
# 描述: 服务器已接受请求,但尚未处理。
HTTP Status 203 (非授权信息)
# 描述: 服务器已成功处理了请求,但返回的信息可能来自另一来源。
HTTP Status 204 (无内容)
# 描述: 服务器成功处理了请求,但没有返回任何内容。
HTTP Status 205 (重置内容)
# 描述: 服务器成功处理了请求,但没有返回任何内容。
HTTP Status 206 (部分内容)
# 描述: 服务器成功处理了部分 GET 请求。
HTTP Status 207 (扩展的状态码)
# 描述: 代表之后的消息体将是一个XML消息,并且可能依照之前子请求数量的不同,包含一系列独立的响应代码。
四. HTTP: Status 3XX (请求被重定向)
这类状态码代表需要客户端采取进一步的操作才能完成请求。通常,这些状态代码用来重定向。
HTTP Status 300 (多种选择)
# 描述: 针对请求,服务器可执行多种操作。服务器可根据请求者 (user agent) 选择一项操作,或提供操作列表供请求者选择。
HTTP Status 301 (永久移动)
# 描述: 请求的网页已永久移动到新位置。 服务器返回此响应(对 GET 或 HEAD 请求的响应)时,会自动将请求者转到新位置。
HTTP Status 302 (临时移动)
# 描述: 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。
HTTP Status 303 (查看其他位置)
# 描述: 请求者应当对不同的位置使用单独的 GET 请求来检索响应时,服务器返回此代码。
HTTP Status 304 (未修改)
# 描述: 自从上次请求后,请求的网页未修改过。 服务器返回此响应时,不会返回网页内容。
HTTP Status 305 (使用代理)
# 描述: 请求者只能使用代理访问请求的网页。 如果服务器返回此响应,还表示请求者应使用代理。
HTTP Status 307 (临时重定向)
# 描述: 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。
五. HTTP: Status 4XX (请求错误)
这些状态代码表示请求可能出错,妨碍了服务器的处理。
HTTP Status 400 (错误请求)
# 描述: 服务器不理解请求的语法。
HTTP Status 401 (未授权)
# 描述: 请求要求身份验证。 对于需要登录的网页,服务器可能返回此响应。
HTTP Status 403 (禁止)
# 描述: 服务器拒绝请求。
HTTP Status 404 (未找到)
# 描述: 服务器找不到请求的网页。
HTTP Status 405 (方法禁用)
# 描述: 禁用请求中指定的方法。
HTTP Status 406 (不接受)
# 描述: 无法使用请求的内容特性响应请求的网页。
HTTP Status 407 (需要代理授权)
# 描述: 此状态代码与 401(未授权)类似,但指定请求者应当授权使用代理。
HTTP Status 408 (请求超时)
# 描述: 服务器等候请求时发生超时。
HTTP Status 409 (冲突)
# 描述: 服务器在完成请求时发生冲突。 服务器必须在响应中包含有关冲突的信息。
HTTP Status 410 (已删除)
# 描述: 如果请求的资源已永久删除,服务器就会返回此响应。
HTTP Status 411 (需要有效长度)
# 描述: 服务器不接受不含有效内容长度标头字段的请求。
HTTP Status 412 (未满足前提条件)
# 描述: 服务器未满足请求者在请求中设置的其中一个前提条件。
HTTP Status 413 (请求实体过大)
# 描述: 服务器无法处理请求,因为请求实体过大,超出服务器的处理能力。
HTTP Status 414 (请求的 URI 过长)
# 描述: 请求的 URI(通常为网址)过长,服务器无法处理。
HTTP Status 415 (不支持的媒体类型)
# 描述: 请求的格式不受请求页面的支持。
HTTP Status 416 (请求范围不符合要求)
# 描述: 如果页面无法提供请求的范围,则服务器会返回此状态代码。
HTTP Status 417 (未满足期望值)
# 描述: 服务器未满足”期望”请求标头字段的要求。
六. HTTP Status 5XX (服务器错误)
这些状态代码表示服务器在尝试处理请求时发生内部错误。 这些错误可能是服务器本身的错误,而不是请求出错。
HTTP Status 500 (服务器内部错误)
# 描述: 服务器遇到错误,无法完成请求。
HTTP Status 501 (尚未实施)
# 描述: 服务器不具备完成请求的功能。 例如,服务器无法识别请求方法时可能会返回此代码。
HTTP Status 502 (错误网关)
# 描述: 服务器作为网关或代理,从上游服务器收到无效响应。
HTTP Status 503 (服务不可用)
# 描述: 服务器目前无法使用(由于超载或停机维护)。 通常,这只是暂时状态。
HTTP Status 504 (网关超时)
# 描述: 服务器作为网关或代理,但是没有及时从上游服务器收到请求。
HTTP Status 505 (HTTP 版本不受支持)
# 描述: 服务器不支持请求中所用的 HTTP 协议版本。