drf-1, postman, restful十条规范,(反)序列化

web开发模式

api接口 及接口测试工具

Restful 十条规范

drf快速使用

web开发模式

web开发有两种模式
1. 前后端混合开发. 既要写前端[js,css,html,模板语法(dtl)]还要写后端[django:python界的web框架].
2. 前后端分离.时下主流框架. 后端人员只写后端, 对外提供接口.
    bom/dom : js操作html 通过js 插入到html中一些表格, div标签.

api接口

它是前后端信息交互的媒介. 有十条规范需要遵守-----restful规范
# 为了在团队内部形成共识、防止个人习惯差异引起的混乱，我们需要找到一种大家都觉得很好的接口实现规范，而且这种规范能够让后端写的接口，用途一目了然，减少双方之间的合作成本.


# 接口的概念很大---》api接口 --->只针对于 http请求返回xml，json数据的这种接口

api接口测试工具

postman为例

form-data ---- 上传文件
urlencoded ---- form, ajax表单默认
json请求编码 ---- 只能用ajax, contentType:application/json


**在django中,如果使用form-data 或者urlencoded编码, 提交数据直接从[POST]取出来,**
**如果是json格式数据,从[POST]取不出来, 只能从request.body取出来, json转化一下才能用.**


# postman 就是一个替代浏览器，发送http请求的工具
# 因为用浏览器不能发送post请求，只能用代码写ajax发请求
# 通过postman可以发送任意请求


# collection:可以批量的管理，导入导入很多api接口
	-测试数据都带着，不会丢

restful规范

restful 规范(Representational State Transfer)表征状态转移
restful是一种定义webAPI接口的设计风格, 尤其适用于前后端分离的应用模式. 有十条规范:

  -1 使用https数据交互    http+tsl/ssl=https   比http更安全，交互是加密传输
  		-交互用json---》如果很轻易被截获---》明文显示给别人，数据不安全
  -2 接口地址中带api标识
    	https://api.baidu.com/books   域名中
    	https://www.baidu.com/api     地址中
  -3 接口地址中标识版本标识
    	-https://api.baidu.com/v1
			-https://api.weibo.com/2/statuses/user_timeline.json
      -登陆功能：用户名密码  如果把原来的接口改了---》老app还能用吗？
      -升级了app：用户名密码验证码  新写一个接口
  -4 数据即是资源，均使用名词，不要出现动词
  		-删除图书接口
    -好的：https://api.baidu.com/v1/books
    -不好的：https://api.baidu.com/v1/delete-books
     
    	-新增图书:https://api.baidu.com/v1/books
  - 5 资源操作由请求方式决定
  	-新增图书：https://api.baidu.com/v1/books    post
    -删除图书：https://api.baidu.com/v1/books    delete
    -修改图书：https://api.baidu.com/v1/books    put
    -获取图书：https://api.baidu.com/v1/books    get
      
      
  - 6 地址中带搜索条件
  	-https://api.example.com/v1/zoos?animal_type_id=1：指定筛选条件
    -https://api.baidu.com/v1/books?name=红楼梦
      
   -7 响应状态码
  		-http的响应状态码
    		-1xx   请求正在处理
      	-2xx   成功  200 请求成功    201 创建成功
        -3xx   重定向  301 和 302 ---》问301和302的区别？一个是临时重定向一个是永久重定向
        -4xx   客户端错误 403 和 404  403：没有权限   404：地址不存在
        -5xx   服务端错误 
      -响应中带状态码
      	{code:100}
        
   -8 响应中带错误信息
  		{code:999，msg：登陆失败}
    
   -9 针对不同操作，服务器向用户返回的结果应该符合以下规范
      GET /collection：返回资源对象的列表（数组） 
    			-[{name:红楼梦，price：12},{name:西游记，price：12}]
      GET /collection/resource：返回单个资源对象
      		-{name:西游记，price：12}
      POST /collection：返回新生成的资源对象
      		-{name:西厢记，price：12}
      PUT /collection/resource：返回完整的资源对象
      		-{name:西游记，price：12}
      PATCH /collection/resource：返回完整的资源对象
      		-{name:西游记，price：12}
      DELETE /collection/resource：返回一个空文档
      		-
        
   -10 响应中带链接地址
  		

drf快速使用

drf是djangorestframework的缩写, 是一个第三方插件,只能用在django框架上, 可以快速地帮助我们写出符合restful规范的接口.

# drf和django的版本有一定的对应关系
	-django  4.x
  -drf    版本
  -如果是django 2.2.2  drf最新可能不支持（稍微降一下drf版本）

# django 2.2.2(公司用2多)   drf 最新   
	-python 3.8 
	-django 2.2.2
  -drf :3.12.4
# 安装
# 方式一
pip3 install djangorestframework 
# 方式二：
在pycharm中点点点



# 快速使用---》以后见到的所有接口，都是这5个和变形
  -增加图书：
  -获取一本图书
  -获取所有图书
  -删除一本图书
  -修改一本图书