
点击跳转到 Rest-Framework 专栏目录
在请求中我们会用到和种各样的请求状态码, 如果你查阅过文档, 会在首行看到这样一条信息:
Using bare status codes in your responses isn’t recommended. REST framework includes a set of named constants that you can use to make your code more obvious and readable.
是的, 使用框架自带的状态码能更清晰的表达这个请求的相应内容以及错误信息, 你只需要这样导入进来就可以使用了:
#!/usr/bin/env python
# _*_ coding: UTF-8 _*_
from rest_framework import status
Informational – 1xx
此类状态码表示临时的信息状态, 在框架中是没有使用这类状态码的。
HTTP_100_CONTINUEHTTP_101_SWITCHING_PROTOCOLS
Successful – 2xx
这类状态码是表示服务器已经成功接收到了请求。
HTTP_200_OKHTTP_201_CREATEDHTTP_202_ACCEPTEDHTTP_203_NON_AUTHORITATIVE_INFORMATIONHTTP_204_NO_CONTENTHTTP_205_RESET_CONTENTHTTP_206_PARTIAL_CONTENTHTTP_207_MULTI_STATUSHTTP_208_ALREADY_REPORTEDHTTP_226_IM_USED
Redirection – 3xx
这类状态码表示重定向到了其他接口, 可能需要进一步访问其他的接口才可以满足用户需求。
HTTP_300_MULTIPLE_CHOICESHTTP_301_MOVED_PERMANENTLYHTTP_302_FOUNDHTTP_303_SEE_OTHERHTTP_304_NOT_MODIFIEDHTTP_305_USE_PROXYHTTP_306_RESERVEDHTTP_307_TEMPORARY_REDIRECTHTTP_308_PERMANENT_REDIRECT
Client Error – 4xx
这类状态码表示客户端出现错误。
HTTP_400_BAD_REQUESTHTTP_401_UNAUTHORIZEDHTTP_402_PAYMENT_REQUIREDHTTP_403_FORBIDDENHTTP_404_NOT_FOUNDHTTP_405_METHOD_NOT_ALLOWEDHTTP_406_NOT_ACCEPTABLEHTTP_407_PROXY_AUTHENTICATION_REQUIREDHTTP_408_REQUEST_TIMEOUTHTTP_409_CONFLICTHTTP_410_GONEHTTP_411_LENGTH_REQUIREDHTTP_412_PRECONDITION_FAILEDHTTP_413_REQUEST_ENTITY_TOO_LARGEHTTP_414_REQUEST_URI_TOO_LONGHTTP_415_UNSUPPORTED_MEDIA_TYPEHTTP_416_REQUESTED_RANGE_NOT_SATISFIABLEHTTP_417_EXPECTATION_FAILEDHTTP_422_UNPROCESSABLE_ENTITYHTTP_423_LOCKEDHTTP_424_FAILED_DEPENDENCYHTTP_426_UPGRADE_REQUIREDHTTP_428_PRECONDITION_REQUIREDHTTP_429_TOO_MANY_REQUESTSHTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGEHTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS
Server Error – 5xx
这类状态码表示服务端出现错误。
HTTP_500_INTERNAL_SERVER_ERRORHTTP_501_NOT_IMPLEMENTEDHTTP_502_BAD_GATEWAYHTTP_503_SERVICE_UNAVAILABLEHTTP_504_GATEWAY_TIMEOUTHTTP_505_HTTP_VERSION_NOT_SUPPORTEDHTTP_506_VARIANT_ALSO_NEGOTIATESHTTP_507_INSUFFICIENT_STORAGEHTTP_508_LOOP_DETECTEDHTTP_509_BANDWIDTH_LIMIT_EXCEEDEDHTTP_510_NOT_EXTENDEDHTTP_511_NETWORK_AUTHENTICATION_REQUIRED
辅助函数
is_informational() # 1xx 返回是否 1 开头状态码的布尔值
is_success() # 2xx 返回是否 2 开头状态码的布尔值
is_redirect() # 3xx 返回是否 3 开头状态码的布尔值
is_client_error() # 4xx 返回是否 4 开头状态码的布尔值
is_server_error() # 5xx 返回是否 5 开头状态码的布尔值
例如:
#!/usr/bin/env python
# _*_ coding: UTF-8 _*_
from rest_framework import status
status.is_success(200) # 返回 True