RESTFUL中HTTP状态码归纳

常用

•2xx操作成功

o200正常的成功返回

o201服务器资源已经存在,直接返回

o202请求已提交,正在异步处理

•3xx地址重定向,接口或地址已经被移走

•4xx客户端请求错误

o400客户端通用请求出错

o401未登录或会话过期(需要登录但未登录或会话过期)

o403没有权限访问、操作(IP受限或已登录但没权限)

o404接口不存在或请求地址不存在

o405请求方法不对如需要GET请求,实际是POST请求

o409请求的业务数据存在冲突,如工号或身份证被占用

•5xx服务器错误,操作失败

详细状态信息

1xx-信息提示

这些状态代码表示临时的响应。客户端在收到常规响应之前,应准备接收一个或多个1xx响应。

•0-本地响应成功。

•100-Continue初始的请求已经接受,客户应当继续发送请求的其余部分。(HTTP1.1新)

•101-SwitchingProtocols服务器将遵从客户的请求转换到另外一种协议。(HTTP1.1新)

2xx-成功

这类状态代码表明服务器成功地接受了客户端请求。

•200-OK一切正常,对GET和POST请求的应答文档跟在后面。

•201-Created服务器已经创建了文档,Location头给出了它的URL。

•202-Accepted已经接受请求,但处理尚未完成。

•203-Non-AuthoritativeInformation文档已经正常地返回,但一些应答头可能不正确,因为使用的是文档的拷贝,非权威性信息(HTTP1.1新)。

•204-NoContent没有新文档,浏览器应该继续显示原来的文档。如果用户定期地刷新页面,而Servlet可以确定用户文档足够新,这个状态代码是很有用的。

•205-ResetContent没有新的内容,但浏览器应该重置它所显示的内容。用来强制浏览器清除表单输入内容(HTTP1.1新)。

•206-PartialContent客户发送了一个带有Range头的GET请求,服务器完成了它(HTTP1.1新)。

3xx-重定向

客户端浏览器必须采取更多操作来实现请求。

•300-MultipleChoices客户请求的文档可以在多个位置找到,这些位置已经在返回的文档内列出。如果服务器要提出优先选择,则应该在Location应答头指明。

•301-MovedPermanently客户请求的文档在其他地方,新的URL在Location头中给出,浏览器应该自动地访问新的URL。

•302-Found类似于301,但新的URL应该被视为临时性的替代,而不是永久性的。注意,在HTTP1.0中对应的状态信息是“MovedTemporatily”。出现该状态代码时,浏览器能够自动访问新的URL,因此它是一个很有用的状态代码。注意这个状态代码有时候可以和301替换使用。例如,如果浏览器错误地请求http://host/~user(缺少了后面的斜杠),有的服务器返回301,有的则返回302。严格地说,我们只能假定只有当原来的请求是GET时浏览器才会自动重定向。请参见307。

•303-SeeOther类似于301/302,不同之处在于,如果原来的请求是POST,Location头指定的重定向目标文档应该通过GET提取(HTTP1.1新)。

•304-NotModified客户端有缓冲的文档并发出了一个条件性的请求(一般是提供If-Modified-Since头表示客户只想比指定日期更新的文档)。服务器告诉客户,原来缓冲的文档还可以继续使用。

•305-UseProxy客户请求的文档应该通过Location头所指明的代理服务器提取(HTTP1.1新)。

•307-TemporaryRedirect和302(Found)相同。许多浏览器会错误地响应302应答进行重定向,即使原来的请求是POST,即使它实际上只能在POST请求的应答是303时才能重定向。由于这个原因,HTTP1.1新增了307,以便更加清除地区分几个状态代码:当出现303应答时,浏览器可以跟随重定向的GET和POST请求;如果是307应答,则浏览器只能跟随对GET请求的重定向。(HTTP1.1新)

4xx-客户端错误

发生错误,客户端似乎有问题。例如,客户端请求不存在的页面,客户端未提供有效的身份验证信息。

•400-BadRequest请求出现语法错误。

•401-Unauthorized访问被拒绝,客户试图未经授权访问受密码保护的页面。应答中会包含一个WWW-Authenticate头,浏览器据此显示用户名字/密码对话框,然后在填写合适的Authorization头后再次发出请求。IIS定义了许多不同的401错误,它们指明更为具体的错误原因。这些具体的错误代码在浏览器中显示,但不在IIS日志中显示:

•401.1-登录失败。

•401.2-服务器配置导致登录失败。

•401.3-由于ACL对资源的限制而未获得授权。

•401.4-筛选器授权失败。

•401.5-ISAPI/CGI应用程序授权失败。

•401.7–访问被Web服务器上的URL授权策略拒绝。这个错误代码为IIS6.0所专用。

•403-Forbidden资源不可用。服务器理解客户的请求,但拒绝处理它。通常由于服务器上文件或目录的权限设置导致。禁止访问:IIS定义了许多不同的403错误,它们指明更为具体的错误原因:

•403.1-执行访问被禁止。

•403.2-读访问被禁止。

•403.3-写访问被禁止。

•403.4-要求SSL。

•403.5-要求SSL128。

•403.6-IP地址被拒绝。

•403.7-要求客户端证书。

•403.8-站点访问被拒绝。

•403.9-用户数过多。

•403.10-配置无效。

•403.11-密码更改。

•403.12-拒绝访问映射表。

•403.13-客户端证书被吊销。

•403.14-拒绝目录列表。

•403.15-超出客户端访问许可。

•403.16-客户端证书不受信任或无效。

•403.17-客户端证书已过期或尚未生效。

•403.18-在当前的应用程序池中不能执行所请求的URL。这个错误代码为IIS6.0所专用。

•403.19-不能为这个应用程序池中的客户端执行CGI。这个错误代码为IIS6.0所专用。

•403.20-Passport登录失败。这个错误代码为IIS6.0所专用。

•404-NotFound无法找到指定位置的资源。这也是一个常用的应答。

•404.0-(无)–没有找到文件或目录。

•404.1-无法在所请求的端口上访问Web站点。

•404.2-Web服务扩展锁定策略阻止本请求。

•404.3-MIME映射策略阻止本请求。

•405-MethodNotAllowed请求方法(GET、POST、HEAD、DELETE、PUT、TRACE等)对指定的资源不适用,用来访问本页面的HTTP谓词不被允许(方法不被允许)(HTTP1.1新)

•406-NotAcceptable指定的资源已经找到,但它的MIME类型和客户在Accpet头中所指定的不兼容,客户端浏览器不接受所请求页面的MIME类型(HTTP1.1新)。

•407-ProxyAuthenticationRequired要求进行代理身份验证,类似于401,表示客户必须先经过代理服务器的授权。(HTTP1.1新)

•408-RequestTimeout在服务器许可的等待时间内,客户一直没有发出任何请求。客户可以在以后重复同一请求。(HTTP1.1新)

•409-Conflict通常和PUT请求有关。由于请求和资源的当前状态相冲突,因此请求不能成功。(HTTP1.1新)

•410-Gone所请求的文档已经不再可用,而且服务器不知道应该重定向到哪一个地址。它和404的不同在于,返回407表示文档永久地离开了指定的位置,而404表示由于未知的原因文档不可用。(HTTP1.1新)

•411-LengthRequired服务器不能处理请求,除非客户发送一个Content-Length头。(HTTP1.1新)

•412-PreconditionFailed请求头中指定的一些前提条件失败(HTTP1.1新)。

•413–RequestEntityTooLarge目标文档的大小超过服务器当前愿意处理的大小。如果服务器认为自己能够稍后再处理该请求,则应该提供一个Retry-After头(HTTP1.1新)。

•414-RequestURITooLongURI太长(HTTP1.1新)。

•415–不支持的媒体类型。

•416–RequestedRangeNotSatisfiable服务器不能满足客户在请求中指定的Range头。(HTTP1.1新)

•417–执行失败。

•423–锁定的错误。

5xx-服务器错误

服务器由于遇到错误而不能完成该请求。

•500-InternalServerError服务器遇到了意料不到的情况,不能完成客户的请求。

•500.12-应用程序正忙于在Web服务器上重新启动。

•500.13-Web服务器太忙。

•500.15-不允许直接请求Global.asa。

•500.16–UNC授权凭据不正确。这个错误代码为IIS6.0所专用。

•500.18–URL授权存储不能打开。这个错误代码为IIS6.0所专用。

•500.100-内部ASP错误。

•501-NotImplemented服务器不支持实现请求所需要的功能,页眉值指定了未实现的配置。例如,客户发出了一个服务器不支持的PUT请求。

•502-BadGateway服务器作为网关或者代理时,为了完成请求访问下一个服务器,但该服务器返回了非法的应答。亦说Web服务器用作网关或代理服务器时收到了无效响应。

•502.1-CGI应用程序超时。

•502.2-CGI应用程序出错。

•503-ServiceUnavailable服务不可用,服务器由于维护或者负载过重未能应答。例如,Servlet可能在数据库连接池已满的情况下返回503。服务器返回503时可以提供一个Retry-After头。这个错误代码为IIS6.0所专用。

•504-GatewayTimeout网关超时,由作为代理或网关的服务器使用,表示不能及时地从远程服务器获得应答。(HTTP1.1新)。

•505-HTTPVersionNotSupported服务器不支持请求中所指明的HTTP版本。

相关推荐