Django REST Framework 教程：构建你的第一个API 📚💻

简介

Django REST Framework（DRF）是 Django 生态中用于构建 Web API 的强大工具。它简化了接口开发流程，支持序列化、认证、权限等功能。

安装与配置

1. 安装包

   pip install djangorestframework  
   

   📦 安装完成后，需在 settings.py 中添加 'rest_framework' 到 INSTALLED_APPS。

2. 创建项目
   使用 django-admin startproject 初始化项目，然后通过 startapp 创建一个新应用。
   ⚙️ 示例：

   django-admin startproject myapi  
   cd myapi  
   python manage.py startapp posts  
   

快速入门步骤

• 定义模型
  在 models.py 中创建数据结构。
  🛠️ 示例：

  from django.db import models  
  
  class Post(models.Model):  
      title = models.CharField(max_length=100)  
      content = models.TextField()  
      created_at = models.DateTimeField(auto_now_add=True)  
  

• 序列化器
  将模型转换为JSON格式。
  🧾 示例：

  from rest_framework import serializers  
  from .models import Post  
  
  class PostSerializer(serializers.ModelSerializer):  
      class Meta:  
          model = Post  
          fields = '__all__'  
  

• 视图与路由
  使用 ViewSet 和 Router 自动生成API端点。
  🧭 示例：

  from rest_framework import viewsets  
  from .models import Post  
  from .serializers import PostSerializer  
  
  class PostViewSet(viewsets.ModelViewSet):  
      queryset = Post.objects.all()  
      serializer_class = PostSerializer  
  

  路由配置：

  from django.urls import path, include  
  from rest_framework.routers import DefaultRouter  
  from .views import PostViewSet  
  
  router = DefaultRouter()  
  router.register(r'posts', PostViewSet)  
  
  urlpatterns = [  
      path('', include(router.urls)),  
  ]  
  

测试API

启动开发服务器后，访问 http://localhost:8000/posts/ 查看接口文档。
🔍 使用工具如 Postman 或 curl 发送请求，验证数据返回是否符合预期。

扩展阅读

想要深入了解DRF高级功能？点击前往 Django REST Framework 高级教程 🚀