Http(s) API调用的响应状态码大全
| 状态码 |
编码 |
错误码说明 |
| 1打头的-----信息，服务器收到请求，需要请求者继续执行操作 | ||
| 100 |
Continue |
继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 详解： 客户端应当继续发送请求。这个临时响应是用来通知客户端它的部分请求已经被服务器接收，且仍未被拒绝。客户端应当继续发送请求的剩余部分，或者如果请求已经完成，忽略这个响应。服务器必须在请求完成后向客户端发送一个最终响应。 |
| 101 |
Switching Protocols |
切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 详解： 服务器已经理解了客户端的请求，并将通过Upgrade 消息头通知客户端采用不同的协议来完成这个请求。在发送完这个响应最后的空行后，服务器将会切换到在Upgrade 消息头中定义的那些协议。 只有在切换新的协议更有好处的时候才应该采取类似措施。例如，切换到新的HTTP 版本比旧版本更有优势，或者切换到一个实时且同步的协议以传送利用此类特性的资源。 |
| 102 | 由WebDAV（RFC 2518）扩展的状态码，代表处理将被继续执行。 | |
| 2打头的-----成功，操作被成功接收并处理 | ||
| 200 | OK | 请求成功。一般用于GET与POST请求。详解： 请求已成功，请求所希望的响应头或数据体将随此响应返回。 |
| 201 |
Created |
创建类的请求完全成功。详解： 请求已经被实现，而且有一个新的资源已经依据请求的需要而建立，且其 URI 已经随Location 头信息返回。假如需要的资源无法及时建立的话，应当返回 '202 Accepted'。 |
| 202 |
Accepted |
已经接受请求，但未处理完成。 详解： 服务器已接受请求，但尚未处理。正如它可能被拒绝一样，最终该请求可能会也可能不会被执行。在异步操作的场合下，没有比发送这个状态码更方便的做法了。 返回202状态码的响应的目的是允许服务器接受其他过程的请求（例如某个每天只执行一次的基于批处理的操作），而不必让客户端一直保持与服务器的连接直到批处理操作全部完成。在接受请求处理并返回202状态码的响应应当在返回的实体中包含一些指示处理当前状态的信息，以及指向处理状态监视器或状态预测的指针，以便用户能够估计操作是否已经完成。 |
| 203 |
Non-Authoritative Information |
非授权信息，请求成功。 详解： 服务器已成功处理了请求，但返回的实体头部元信息不是在原始服务器上有效的确定集合，而是来自本地或者第三方的拷贝。当前的信息可能是原始版本的子集或者超集。例如，包含资源的元数据可能导致原始服务器知道元信息的超集。使用此状态码不是必须的，而且只有在响应不使用此状态码便会返回200 OK的情况下才是合适的。 |
| 204 |
NoContent |
请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 详解： 服务器成功处理了请求，但不需要返回任何实体内容，并且希望返回更新了的元信息。响应可能通过实体头部的形式，返回新的或更新后的元信息。如果存在这些头部信息，则应当与所请求的变量相呼应。 如果客户端是浏览器的话，那么用户浏览器应保留发送了该请求的页面，而不产生任何文档视图上的变化，即使按照规范新的或更新后的元信息应当被应用到用户浏览器活动视图中的文档。 由于204响应被禁止包含任何消息体，因此它始终以消息头后的第一个空行结尾。 |
| 205 |
Reset Content |
重置内容，服务器处理成功。 详解： 服务器成功处理了请求，且没有返回任何内容。但是与204响应不同，返回此状态码的响应要求请求者重置文档视图。该响应主要是被用于接受用户输入后，立即重置表单，以便用户能够轻松地开始另一次输入。 与204响应一样，该响应也被禁止包含任何消息体，且以消息头后的第一个空行结束。 |
| 206 |
Partial Content |
服务器成功处理了部分GET请求。 详解： 服务器已经成功处理了部分 GET 请求。类似于 FlashGet 或者迅雷这类的 HTTP 下载工具都是使用此类响应实现断点续传或者将一个大文档分解为多个下载段同时下载。 该请求必须包含 Range 头信息来指示客户端希望得到的内容范围，并且可能包含 If-Range 来作为请求条件。 响应必须包含如下的头部域： Content-Range 用以指示本次响应中返回的内容的范围； 如果是 Content-Type 为 multipart/byteranges 的多段下载，则每一 multipart 段中都应包含 Content-Range 域用以指示本段的内容范围。假如响应中包含 Content-Length，那么它的数值必须匹配它返回的内容范围的真实字节数。 Date ETag 和/或 Content-Location，假如同样的请求本应该返回200响应。 Expires, Cache-Control，和/或 Vary，假如其值可能与之前相同变量的其他响应对应的值不同的话。 假如本响应请求使用了 If-Range 强缓存验证，那么本次响应不应该包含其他实体头； 假如本响应的请求使用了 If-Range 弱缓存验证，那么本次响应禁止包含其他实体头；这避免了缓存的实体内容和更新了的实体头信息之间的不一致。否则，本响应就应当包含所有本应该返回200响应中应当返回的所有实体头部域。 假如 ETag 或 Last-Modified 头部不能精确匹配的话，则客户端缓存应禁止将206响应返回的内容与之前任何缓存过的内容组合在一起。 任何不支持 Range 以及 Content-Range 头的缓存都禁止缓存206响应返回的内容。 |
| 207 | 由WebDAV(RFC 2518)扩展的状态码，代表之后的消息体将是一个XML消息，并且可能依照之前子请求数量的不同，包含一系列独立的响应代码。 | |
| 3打头的-----重定向，需要进一步的操作以完成请求 | ||
| 300 |
Multiple Choices |
多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。 详解：被请求的资源有一系列可供选择的回馈信息，每个都有自己特定的地址和浏览器驱动的商议信息。用户或浏览器能够自行选择一个首选的地址进行重定向。 除非这是一个 HEAD 请求，否则该响应应当包括一个资源特性及地址的列表的实体，以便用户或浏览器从中选择最合适的重定向地址。这个实体的格式由 Content-Type 定义的格式所决定。浏览器可能根据响应的格式以及浏览器自身能力，自动作出最合适的选择。当然，RFC 2616规范并没有规定这样的自动选择该如何进行。 如果服务器本身已经有了首选的回馈选择，那么在 Location 中应当指明这个回馈的 URI；浏览器可能会将这个 Location 值作为自动重定向的地址。 此外，除非额外指定，否则这个响应也是可缓存的。 |
| 301 |
Moved Permanently |
永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 详解：被请求的资源已永久移动到新位置，并且将来任何对此资源的引用都应该使用本响应返回的若干个 URI 之一。如果可能，拥有链接编辑功能的客户端应当自动把请求的地址修改为从服务器反馈回来的地址。除非额外指定，否则这个响应也是可缓存的。 新的永久性的 URI 应当在响应的 Location 域中返回。除非这是一个 HEAD 请求，否则响应的实体中应当包含指向新的 URI 的超链接及简短说明。 如果这不是一个 GET 或者 HEAD 请求，因此浏览器禁止自动进行重定向，除非得到用户的确认，因为请求的条件可能因此发生变化。 注意：对于某些使用 HTTP/1.0 协议的浏览器，当它们发送的 POST 请求得到了一个301响应的话，接下来的重定向请求将会变成 GET 方式。 |
| 302 |
Found |
资源被临时移动。 详解：请求的资源现在临时从不同的 URI 响应请求。由于这样的重定向是临时的，客户端应当继续向原有地址发送以后的请求。只有在Cache-Control或Expires中进行了指定的情况下，这个响应才是可缓存的。 新的临时性的 URI 应当在响应的 Location 域中返回。除非这是一个 HEAD 请求，否则响应的实体中应当包含指向新的 URI 的超链接及简短说明。 如果这不是一个 GET 或者 HEAD 请求，那么浏览器禁止自动进行重定向，除非得到用户的确认，因为请求的条件可能因此发生变化。 注意：虽然RFC 1945和RFC 2068规范不允许客户端在重定向时改变请求的方法，但是很多现存的浏览器将302响应视作为303响应，并且使用 GET 方式访问在 Location 中规定的 URI，而无视原先请求的方法。状态码303和307被添加了进来，用以明确服务器期待客户端进行何种反应。 另： 服务器目前正从不同位置的网页响应请求，但请求者应继续使用原有位置来进行以后的请求。此代码与响应 GET 和 HEAD 请求的 301 代码类似，会自动将请求者转到不同的位置。但由于 Googlebot 会继续抓取原有位置并将其编入索引，因此您不应使用此代码来通知 Googlebot 某个页面或网站已被移动。注意：在 HTTP 1.0中，302表示消息是临时移动(Moved Temporarily)的而不是被找到。 |
| 303 |
See Other |
查看其它地址。 使用GET和POST请求查看。 |
| 304 |
Not Modified |
所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 |
| 305 |
Use Proxy |
所请求的资源必须通过代理访问。 |
| 306 |
Unused |
已经被废弃的HTTP状态码。 |
| 4打头的-----客户端错误，请求包含语法错误或无法完成请求 | ||
| 400 |
BadRequest |
非法请求。 建议直接修改该请求，不要重试该请求。 |
| 401 |
Unauthorized |
在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 |
| 402 |
Payment Required |
保留请求。 |
| 403 |
Forbidden |
请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 |
| 404 |
NotFound |
所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 |
| 405 |
MethodNotAllowed |
请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 |
| 406 |
Not Acceptable |
服务器无法根据客户端请求的内容特性完成请求。 |
| 407 |
Proxy Authentication Required |
请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 |
| 408 |
Request Time-out |
服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 |
| 409 |
Conflict |
服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 |
| 410 |
Gone |
客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 |
| 411 |
Length Required |
服务器无法处理客户端发送的不带Content-Length的请求信息。 |
| 412 |
Precondition Failed |
未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 |
| 413 |
Request Entity Too Large |
由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 |
| 414 |
Request-URI Too Large |
请求的URI过长（URI通常为网址），服务器无法处理。 |
| 415 |
Unsupported Media Type |
服务器无法处理请求附带的媒体格式。 |
| 416 |
Requested range not satisfiable |
客户端请求的范围无效。 |
| 417 |
Expectation Failed |
服务器无法满足Expect的请求头信息。 |
| 422 |
UnprocessableEntity |
请求格式正确，但是由于含有语义错误，无法响应。 |
| 429 |
TooManyRequests |
表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 |
| 5打头的-----服务器错误，服务器在处理请求的过程中发生了错误 | ||
| 500 |
InternalServerError |
表明服务端能被请求访问到，但是不能理解用户的请求。 |
| 501 |
Not Implemented |
服务器不支持请求的功能，无法完成请求。 |
| 502 |
Bad Gateway |
充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 |
| 503 |
ServiceUnavailable |
被请求的服务无效。 建议直接修改该请求，不要重试该请求。 |
| 504 |
ServerTimeout |
请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 |
| 505 |
HTTP Version not supported |
服务器不支持请求的HTTP协议的版本，无法完成处理。 |
本博客相关：
《delphi Restful:客户端实现的四种方式及其比较》
《delphi版HTTP/1. 1 405 Method Not Allowed的终极解释及Http(s)请求的常见错误》
喜欢的话，就在下面点个赞、收藏就好了，方便看下次的分享：