响应状态码
状态码
为了方便设置状态码,REST framewrok在rest_framework.status
模块中提供了常用状态码常量。
导入: from rest_framework import status
提示: 默认响应状态码200
1)信息告知 - 1xx
HTTP_100_CONTINUE(继续) 请求者应当继续提出请求。 服务器返回此代码表示已收到请求的第一部分,正在等待其余部分。 HTTP_101_SWITCHING_PROTOCOLS(切换协议) 请求者已要求服务器切换协议,服务器已确认并准备切换。
HTTP_102 由WebDAV(RFC 2518)扩展的状态码,代表处理将被继续执行。
2)成功 - 2xx
HTTP_200_OK(成功) 服务器已成功处理了请求。 通常,这表示服务器提供了请求的网页。 HTTP_201_CREATED(已创建) 请求成功并且服务器创建了新的资源。 HTTP_202_ACCEPTED(已接受) 服务器已接受请求,但尚未处理。 HTTP_203_NON_AUTHORITATIVE_INFORMATION(非授权信息) 服务器已成功处理了请求,但返回的信息可能来自另一来源。 HTTP_204_NO_CONTENT(无内容) 服务器成功处理了请求,但没有返回任何内容。 HTTP_205_RESET_CONTENT(重置内容) 服务器成功处理了请求,但没有返回任何内容。 HTTP_206_PARTIAL_CONTENT(部分内容) 服务器成功处理了部分 GET 请求。 HTTP_208_MULTI_STATUS(已经报告)一个DAV的绑定成员被前一个请求枚举,并且没有被再一次包括。
HTTP_226(IM Used)服务器已经满足了请求所要的资源,并且响应是一个或者多个实例操作应用于当前实例的结果。
3)重定向 - 3xx
HTTP_300_MULTIPLE_CHOICES(多种选择) 针对请求,服务器可执行多种操作。 服务器可根据请求者 (user agent) 选择一项操作,或提供操作列表供请求者选择。
HTTP_301_MOVED_PERMANENTLY(永久移动) 请求的网页已永久移动到新位置。 服务器返回此响应(对 GET 或 HEAD 请求的响应)时,会自动将请求者转到新位置。
HTTP_302_FOUND(临时移动) 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。
HTTP_303_SEE_OTHER(查看其他位置) 请求者应当对不同的位置使用单独的 GET 请求来检索响应时,服务器返回此代码。
HTTP_304_NOT_MODIFIED(未修改) 自从上次请求后,请求的网页未修改过。 服务器返回此响应时,不会返回网页内容。
HTTP_305_USE_PROXY(使用代理) 请求者只能使用代理访问请求的网页。 如果服务器返回此响应,还表示请求者应使用代理。
HTTP_307_RESERVED(临时重定向) 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。
HTTP_308_TEMPORARY_REDIRECT(永久转移)这个请求和以后的请求都应该被另一个URI地址重新发送。307、308和302、301有相同的表现,但是不允许HTTP方法改变。例如,请求表单到一个永久转移的资源将会继续顺利地执行。
4)客户端错误 - 4xx
HTTP_400_BAD_REQUEST(错误请求) 服务器不理解请求的语法。
HTTP_401_UNAUTHORIZED(未授权) 请求要求身份验证。 对于需要登录的网页,服务器可能返回此响应。
HTTP_402_PAYMENT_REQUIRED 该状态码是为了将来可能的需求而预留的。
HTTP_403_FORBIDDEN(禁止) 服务器拒绝请求。
HTTP_404_NOT_FOUND(未找到) 服务器找不到请求的网页。
HTTP_405_METHOD_NOT_ALLOWED(方法禁用) 禁用请求中指定的方法。
HTTP_406_NOT_ACCEPTABLE(不接受) 无法使用请求的内容特性响应请求的网页。
HTTP_407_PROXY_AUTHENTICATION_REQUIRED(需要代理授权) 此状态代码与 401(未授权)类似,但指定请求者应当授权使用代理。
HTTP_408_REQUEST_TIMEOUT(请求超时) 服务器等候请求时发生超时。
HTTP_409_CONFLICT(冲突) 服务器在完成请求时发生冲突。 服务器必须在响应中包含有关冲突的信息。
HTTP_410_GONE(已删除) 如果请求的资源已永久删除,服务器就会返回此响应。
HTTP_411_LENGTH_REQUIRED(需要有效长度) 服务器不接受不含有效内容长度标头字段的请求。
HTTP_412_PRECONDITION_FAILED(未满足前提条件) 服务器未满足请求者在请求中设置的其中一个前提条件。
HTTP_413_REQUEST_ENTITY_TOO_LARGE(请求实体过大) 服务器无法处理请求,因为请求实体过大,超出服务器的处理能力。
HTTP_414_REQUEST_URI_TOO_LONG(请求的 URI 过长) 请求的 URI(通常为网址)过长,服务器无法处理。
HTTP_415_UNSUPPORTED_MEDIA_TYPE(不支持的媒体类型) 请求的格式不受请求页面的支持。
HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE(请求范围不符合要求) 如果页面无法提供请求的范围,则服务器会返回此状态代码。
HTTP_417_EXPECTATION_FAILED(未满足期望值) 服务器未满足"期望"请求标头字段的要求。
HTTP_422_UNPROCESSABLE_ENTITY
HTTP_423_LOCKED
HTTP_424_FAILED_DEPENDENCY 由于之前的某个请求发生的错误,导致当前请求失败,例如 PROPPATCH。(RFC 4918 WebDAV)
HTTP_428_PRECONDITION_REQUIRED(需要前置条件)原始服务器需要有条件的请求。当客户端GET一个资源的状态的时候,同时又PUT回给服务器,与此同时第三方修改状态到服务器上的时候,为了避免丢失更新的问题发生将会导致冲突。
HTTP_429_TOO_MANY_REQUESTS(过多请求)用户已经发送了太多的请求在指定的时间里。用于限制速率。
HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE(请求头部字段太大)服务器由于一个单独的请求头部字段或者是全部的字段太大而不愿意处理请求。
HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS(由于法律原因而无效(因特网草稿))被定义在因特网草稿“一个新的HTTP状态码用于法律限制的资源”。被用于当资源的访问由于法律原因被禁止的时候。例如检查制度或者是政府强制要求禁止访问。一个例子是1953年dystopian的小说Fahrenheit 451就是一个非法的资源。
5)服务器错误 - 5xx
HTTP_500_INTERNAL_SERVER_ERROR(服务器内部错误) 服务器遇到错误,无法完成请求。
HTTP_501_NOT_IMPLEMENTED(尚未实施) 服务器不具备完成请求的功能。 例如,服务器无法识别请求方法时可能会返回此代码。
HTTP_502_BAD_GATEWAY(错误网关) 服务器作为网关或代理,从上游服务器收到无效响应。
HTTP_503_SERVICE_UNAVAILABLE(服务不可用) 服务器目前无法使用(由于超载或停机维护)。 通常,这只是暂时状态。
HTTP_504_GATEWAY_TIMEOUT(网关超时) 服务器作为网关或代理,但是没有及时从上游服务器收到请求。
HTTP_505_HTTP_VERSION_NOT_SUPPORTED(HTTP 版本不受支持) 服务器不支持请求中所用的 HTTP 协议版本。
HTTP_507_INSUFFICIENT_STORAGE 服务器无法存储完成请求所必须的内容。这个状况被认为是临时的。WebDAV (RFC 4918)
HTTP_511_NETWORK_AUTHENTICATION_REQUIRED(需要网络授权)客户端需要授权去火的网络的访问权限。一般用于代理交互中被用来进行网络的访问控制。