API接口与DRF快速使用

web开发模式
API接口
RESTful规范
API接口测试工具
序列化反序列化
DRF快速使用

web开发模式

web开发模式一共有两种：

前后端混合开发：一个程序员即要自己写后端，又要写前端。

前后端分离：后端人员只写后端，向前端提供接口，前端人员根据接口编写前端。

API接口

api接口是前后端信息交互的媒介，由后端人员编写，前端人员可以向接口发送请求以获取数据。

比如下图是微博的一个api接口：

为了在团队内部形成共识、防止个人习惯差异引起的混乱，我们需要找到一种大家都觉得很好的接口实现规范，而且这种规范能够让后端写的接口，用途一目了然，减少双方之间的合作成本。

RESTful规范

RESTful规范是当前api接口主流认可的规范，是一种定义Web API接口的设计风格，尤其适用于前后端分离的应用模式中。

RESTful一共有10条规范：

使用https数据交互，https即是http + tsl/ssl，比http更加安全，交互是加密传输。
接口地址中带api标识：
- https://api.example.com/books
- https://www.example.com/api/
接口地址中带版本标识：
- https://api.example.com/v1
主要防止项目更新后旧接口失效，不会把旧接口替换掉。
数据即是资源，均使用名词，不要用动词：
- 正确：https://api.example.com/books
- 错误：https://api.example.com/delete_books
资源操作由请求方式决定：
- 新增：post请求
- 删除：delete请求
- 修改：put请求
- 获取：get请求
地址中带搜索条件：
- https://api.example.com/books?id=1
响应中带状态码：

除了http的响应状态码，还应该提供自定义状态码。
响应中带错误信息，错误信息用error做key：
针对不同请求，服务器向用户返回的结果应该符合以下规范：
- GET /books：返回资源对象的列表（数组）：
```
[
    {
        'id':1,
        'name':'西游记'
    },
    {
        'id':2,
        'name':'红楼梦'
    },
    ...
]
```
- GET /books/1：返回单个资源对象：
```
{
    'id':1,
    'name':'西游记'
}
```
- POST /books：返回新生成的资源对象：
```
{
    'id':3,
    'name':'水浒传'
}
```
- PUT /books/1：返回完整的资源对象
- PATCH /books/1：返回完整的资源对象
- DELETE /books/1：返回一个空文档
响应结果中提供链接，连向其他API方法，使得用户不查文档，也知道下一步应该做什么。
```
{
    'id':'books/1',
    'name':'水浒传'
}
```