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版本。