Python 如何开发出RESTful Web接口，DRF框架助力灵活实现!

本文介绍: API（应用程序接口）是一组定义了软件组件如何互相交互的规范。API 是一些功能、定义或者协议的集合，通过 API 接口实现计算机软件之间的相互通信。对外封装完善，调用时无需学习 API 内部源码，依据 API 文档功能说明书来使用即可。API 同时也是一种中间件，为各种不同平台提供数据共享。是一个建立在Django基础之上的Web 应用开发框架，可以快速的开发REST API接口应用。

Django Rest Framework（DRF）是构建强大且灵活的Web API的优秀工具。它基于Django，提供了一套用于构建Web API的组件和工具，简化了API开发过程，同时保留了Django的优雅和强大。

一、Web应用 模式

在开发Web应用时，通常有两种开发模式。

1、前后端不分离

前端页面看到的效果都是由后端控制，由后端渲染页面或重定向，前端与后端的耦合度很高。

这种应用模式比较适合纯网页应用，但是当后端对接Ap p时，Ap p可能并不需要后端返回一个HTML网页，而仅仅是数据本身，所以后端原本返回网页的接口不再适用于前端App应用，为了对接App后端还需再开发一套接口。

2、前后端分离

后端仅返回前端所需的数据，不再渲染HTML页面，不再控制前端的效果。

至于前端用户看到什么效果，从后端请求的数据如何加载到前端中，都由前端自己决定，网页有网页的处理方式，App有App的处理方式，但无论哪种前端，所需的数据基本相同，后端仅需开发一套逻辑对外提供数据即可。

前后端分离模式优点：

• 提升开发效率
• 完美应对复杂多变的前端需求
• 增强代码可维护性

二、什么是API 接口？

API（应用程序接口）是一组定义了软件组件如何互相交互的规范。

API 是一些功能、定义或者协议的集合，通过 API 接口实现计算机软件之间的相互通信。对外封装完善，调用时无需学习 API 内部源码，依据 API 文档功能说明书来使用即可。

API 同时也是一种中间件，为各种不同平台提供数据共享。

API接口的数据 格式有哪些？

目前 API 接口支持 XLSX、JSON、XML、CSV、RDF 等数据格式，其中 JSON 和 XML 是主流的数据格式，几乎所有 API 接口都支持这两种数据格式。

而 RESTful API 是一种基于REST架构风格设计的API。它使用统一的接口和状态无关的通信方式来实现各种网络应用。这种设计风格使得RESTful API具有简单、灵活、可扩展和易于理解的特点，因此在Web开发中得到了广泛的应用。

Django Rest Framework 正是基于Rest架构风格设计的一款后端API 框架。

三、RESTful API

RESTful 是一种定义 Web API 接口的设计风格，尤其适用于前后端分离的应用模式中。

这种风格的理念认为后端开发任务就是提供数据的，对外提供的是数据资源的访问接口，所以在定义接口时，客户端访问的URL路径就表示这种要操作的数据资源。

事实上，我们可以使用任何一个框架都可以实现符合restful 规范的API接口。

1、数据安全

RESTful API 链接一般都采用https 协议进行传输，以提高数据交互过程中的安全性。

2、接口特征

通常用api关键字标识接口url。

https://api.github.io/   
https://github.io/api

3、多数据版本共存

在url 链接中标识数据版本。

https://api.github.io/v1   
https://github.io/api/v2

注：url 链接中的v1、v2就是不同数据版本的体现（一种数据资源有多版本情况下，也适用于新旧版本间）

4、数据即是资源，均使用名词（可复数）

接口一般都是完成前后台数据的交互，交互的数据我们称之为资源。

https://api.github.io/v1/users

注：一般提倡用资源的复数形式，在url 链接中千万不要出现操作资源的动词

错误示范：https://api.github.io/v1/delete-user

特殊的接口可以出现动词，因为这些接口一般没有一个明确的资源，或是动词就是接口的核心含义

https://api.github.io/login

5、资源操作由请求方式决定

操作资源一般都会涉及到增删改查，我们提供请求方式来标识增删改查动作。

https://api.github.io/users - get请求：获取所有用户   
https://api.github.io/users/1 - get请求：获取ID为1的用户   
https://api.github.io/users - post请求：新增一个用户   
https://api.github.io/users/1 - put请求：整体修改ID为1的用户   
https://api.github.io/users/1 - patch请求：局部修改ID为1的用户   
https://api.github.io/users/1 - delete请求：删除ID为1的用户

6、通过在url 上传参的形式传递搜索 条件

https://api.github.io/v1/projects?page=5&amp;per_page=10  指定第几页，以及每页的记录数

7、错误处理，应返回错误 信息

{       error: "服务器发生错误"   }

四、Django Rest Framework

1、DRF 简介

Django REST framework 是一个建立在Django基础之上的Web 应用开发框架，可以快速的开发REST API接口应用。

DRF优点：

提供了定义序列化器Serializer的方法，可以快速根据 Django ORM 或者其它库自动序列化/反序列化；
提供了丰富的类视图、Mix in 扩展类，简化视图的编写；
丰富的定制层级：函数视图、类视图、视图集合到自动生成 API，满足各种需要；
多种身份认证和权限认证方式的支持 JWT；
内置了限流系统；
直观的 API web 界面；
可扩展性，插件丰富

2、安装和设置

首先，确保你的项目已经安装了Django。然后，使用以下命令安装DRF：

pip install djangorestframework

接下来，在你的Django项目的settings.py中添加以下行：

INSTALLED_APPS = [       # ...       'rest_framework',   ]

然后，配置你的URL以包含DRF的路由：

from django.urls import path, include      
urlpatterns = [       
# ...       
path('api/', include('rest_framework.urls')),   
]

3、创建一个简单的API视图

现在，我们来创建一个简单的API视图。首先，定义一个序列化器：

from rest_framework import serializers      
class MyModelSerializer(serializers.ModelSerializer):       
    class Meta:           
        model = MyModel           
        fields = 'all'

然后，创建一个基于类的视图：

from rest_framework import generics   
from .models import MyModel   
from .serializers import MyModelSerializer      
class MyModelListView(generics.ListCreateAPIView):       
     queryset = MyModel.objects.all()       
     serializer_class = MyModelSerializer

最后，在你的urls.py中添加这个视图：

from django.urls import path   
from .views import MyModelListView      
urlpatterns = [       
# ...       
path('mymodel/', MyModelListView.as_view(), name='mymodel-list'),   
]