Rest-framework專欄講解(四)：status

---

點擊跳轉到 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_CONTINUE
• HTTP_101_SWITCHING_PROTOCOLS

Successful - 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
• HTTP_207_MULTI_STATUS
• HTTP_208_ALREADY_REPORTED
• HTTP_226_IM_USED

Redirection - 3xx

這類狀態碼錶示重定向到了其餘接口, 可能須要進一步訪問其餘的接口才能夠知足用戶需求。

• HTTP_300_MULTIPLE_CHOICES
• HTTP_301_MOVED_PERMANENTLY
• HTTP_302_FOUND
• HTTP_303_SEE_OTHER
• HTTP_304_NOT_MODIFIED
• HTTP_305_USE_PROXY
• HTTP_306_RESERVED
• HTTP_307_TEMPORARY_REDIRECT
• HTTP_308_PERMANENT_REDIRECT

Client Error - 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
• 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
• 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
• HTTP_426_UPGRADE_REQUIRED
• HTTP_428_PRECONDITION_REQUIRED
• HTTP_429_TOO_MANY_REQUESTS
• HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE
• HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS

Server Error - 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_506_VARIANT_ALSO_NEGOTIATES
• HTTP_507_INSUFFICIENT_STORAGE
• HTTP_508_LOOP_DETECTED
• HTTP_509_BANDWIDTH_LIMIT_EXCEEDED
• HTTP_510_NOT_EXTENDED
• HTTP_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
複製代碼