Django 如何使用 Django Rest API 上传文件

在本文中，我们将介绍如何使用 Django Rest API 上传文件。文件上传是Web应用程序开发中常见的需求之一，使用Django Rest Framework可以方便地实现文件上传功能。

阅读更多：Django 教程

Django Rest Framework 简介

Django Rest Framework是基于Django的Web API框架，它提供了一套灵活且强大的工具来构建Web API。它可以帮助我们快速构建高质量的Web API，并且提供了许多内置功能，如序列化、身份验证、权限控制等。

配置 Django Rest Framework

首先，我们需要在Django项目中安装并配置Django Rest Framework。可以使用以下命令来进行安装：

pip install djangorestframework

然后，在settings.py文件中将rest_framework添加到INSTALLED_APPS列表中：

INSTALLED_APPS = [
    ...
    'rest_framework',
]

创建文件上传API

接下来，我们需要创建一个文件上传的API。首先，在models.py文件中创建一个模型来保存上传的文件：

from django.db import models

class UploadedFile(models.Model):
    file = models.FileField(upload_to='uploads/')
    uploaded_at = models.DateTimeField(auto_now_add=True)

这个模型有一个file字段用于保存上传的文件，并且有一个uploaded_at字段用于保存上传时间。

然后，在serializers.py文件中创建一个序列化器来序列化模型数据：

from rest_framework import serializers
from .models import UploadedFile

class UploadedFileSerializer(serializers.ModelSerializer):
    class Meta:
        model = UploadedFile
        fields = '__all__'

接着，在views.py文件中创建一个视图来处理文件上传请求：

from rest_framework import generics
from .models import UploadedFile
from .serializers import UploadedFileSerializer

class UploadFileView(generics.CreateAPIView):
    queryset = UploadedFile.objects.all()
    serializer_class = UploadedFileSerializer

最后，在urls.py文件中定义文件上传的URL：

from django.urls import path
from .views import UploadFileView

urlpatterns = [
    path('upload/', UploadFileView.as_view(), name='upload_file'),
]

现在，我们已经完成了文件上传API的创建。

使用 Postman 进行文件上传测试

为了测试文件上传的API，我们可以使用 Postman 这个强大的API测试工具。

首先，启动Django开发服务器：

python manage.py runserver

然后，在 Postman 中创建一个 POST 请求，设置URL为http://localhost:8000/upload/，选择 form-data 作为请求体类型。

在Key列中，设置 file 为 File 类型，并选择一个要上传的文件。然后点击 Send 按钮发送请求。

如果一切配置正确，文件上传请求将会成功，并且文件将会保存在media/uploads/目录下。同时，API将会返回一个包含上传文件信息的JSON响应。

总结

通过上述步骤，我们成功地使用 Django Rest API 实现了文件上传功能。通过使用 Django Rest Framework 提供的功能，我们可以快速构建高质量的Web API，轻松实现各种需求。

在开发过程中，还可以考虑文件大小的限制、文件类型的校验和文件名的处理等。另外，更多关于 Django Rest Framework 的功能和用法，请参考官方文档。

希望本文对你在 Django Rest API 中实现文件上传有所帮助！