通过django-rest-framework中的status模块来学习HTTP状态码

         Django下面有一个特别实用的框架,就是django-rest-framework,用它你可以写出更符合restful标准的api,本篇会通读django-rest-framework下的status模块来学习http返回的状态码是如何定义的,如果你正在写API相关的接口,本篇文章对你会有一定的帮助,希望你能够通读下去。


在开始之前我们需要安装一下django-rest-framework的框架:

  1. pip install djangorestframework

状态码范围的定义

HTTP状态码分为1xx,2xx,3xx,4xx,5xx,那么每个范围代表什么意思呢?如下表,我已经把它列出来了

范围 描述
1xx 信息
2xx 成功
3xx 重定向
4xx 客户端错误
5xx 服务端错误

然而,在status模块中,为我们提供了几个方法用来验证此状态码是否是这个错误,比如说,我使用requests模块请求了某个网站,然后我要判断是否请求成功,因为要根据不同的结果做不同的事情,实例代码如下:

  1. from rest_framework import status
  2. import requests
  3. # 定义一个URL
  4. URL ='https://blog.ansheng.me'
  5. # 发送一次请求
  6. result = requests.get(URL)
  7. # 如果返回值是成功的状态码就输出
  8. if status.is_success(result.status_code):
  9. print('请求成功!')
  10. # 在发送一个请求
  11. ret = requests.get(URL +'/hello')
  12. # 如果返回值是客户端错误的就输出
  13. if status.is_client_error(ret.status_code):
  14. print('客户端出错!')

返回结果如下:

  1. /Library/Frameworks/Python.framework/Versions/3.5/bin/python3.5/Users/ansheng/MyPythonCode/code.py
  2. 请求成功!
  3. 客户端出错!
  • 源码是怎么干的?

如果你要问我是怎么知道状态码范围的定义的,那么我只能告诉你,源码告诉我了,所以我知道了。

  1. def is_informational(code):
  2. return code >=100 and code <=199
  3. def is_success(code):
  4. return code >=200 and code <=299
  5. def is_redirect(code):
  6. return code >=300 and code <=399
  7. def is_client_error(code):
  8. return code >=400 and code <=499
  9. def is_server_error(code):
  10. return code >=500 and code <=599

常用的HTTP状态码

发现如果要一个一个的说明每个状态码是干什么使的,会浪费很多的精力去看这些不是那么重要的问题,所以我会把几个常用的状态码列举出来,然后剩下的我会推荐几篇文章,如果你真的感兴趣(虽然不推荐这么做,浪费时间)

状态码 描述
200 请求处理成功
201 当服务端根据客户端的请求创建了新的资源后会返回该状态吗
202 根据客户端的请求修改数据时(如果是一个异步的操作,不能确保次修改一定成功)
400 客户端发送过来的参数出现了问题
401 用户验证失败,指访问该资源需要身份验证,但客户端提供的Token貌似是错误的
403 访问的资源是存在的,但是该资源仅允许指定的用户或者IP访问
404 要访问的资源不存在
405 如果一个资源仅允许GET方法来进行资源的获取,那么你用POST/PUT/DELETE等方法进行访时,是不允许的
500 服务器内部错误
502 代理访问后端服务无响应
504 代理访问后端服务超时,与502一样

推荐的一些资源。

  1. See RFC 2616 - http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
  2. And RFC 6585 - http://tools.ietf.org/html/rfc6585
  3. And RFC 4918 - https://tools.ietf.org/html/rfc4918

猜你喜欢

转载自hugoren.iteye.com/blog/2368095