使用rest_framework.renderersBrowsableAPIRenderer()使API具备浏览器呈现能力

rest_framework.renderers.BrowsableAPIRenderer()是Django REST framework中的一个渲染器类，用于将API呈现为可浏览的形式。该类将API的响应数据渲染成HTML，并为每个API端点生成用户友好的页面，使开发人员和用户可以方便地浏览和调试API。

使用rest_framework.renderers.BrowsableAPIRenderer()非常简单，只需要在Django REST framework的视图类中将该渲染器添加到对应的渲染器列表中即可。

下面是一个简单的示例，展示如何使用rest_framework.renderers.BrowsableAPIRenderer()使API具备浏览器呈现能力：

首先，安装Django和Django REST framework：

pip install django
pip install djangorestframework

创建一个基本的Django项目和应用：

django-admin startproject api_project
cd api_project
python manage.py startapp api_app

在api_project/api_project/settings.py文件中，将Django REST framework添加到INSTALLED_APPS列表中：

INSTALLED_APPS = [
    ...
    'django.contrib.staticfiles',
    'rest_framework',
    'api_app',
]

在api_project/api_project/urls.py文件中，配置API的URL路由：

from django.urls import include, path
from rest_framework import routers
from api_app import views

router = routers.DefaultRouter()
router.register(r'users', views.UserViewSet)

urlpatterns = [
    path('', include(router.urls)),
    path('api-auth/', include('rest_framework.urls'))  # 添加REST framework的登录和权限管理URL
]

在api_app/views.py文件中，编写一个简单的视图类：

from django.contrib.auth.models import User
from rest_framework import viewsets
from api_app.serializers import UserSerializer

class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all()
    serializer_class = UserSerializer

在api_app/serializers.py文件中，编写一个简单的序列化类：

from django.contrib.auth.models import User
from rest_framework import serializers

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['id', 'username', 'email']

在api_app/models.py文件中，使用Django默认的User模型：

from django.contrib.auth.models import User

最后，在api_app/views.py文件中，将rest_framework.renderers.BrowsableAPIRenderer()渲染器添加到视图类的渲染器列表中：

from django.contrib.auth.models import User
from rest_framework import viewsets
from api_app.serializers import UserSerializer
from rest_framework.renderers import BrowsableAPIRenderer

class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all()
    serializer_class = UserSerializer
    renderer_classes = [BrowsableAPIRenderer]  # 添加BrowsableAPIRenderer渲染器

现在，执行以下命令启动Django开发服务器：

python manage.py runserver

在浏览器中访问http://127.0.0.1:8000/api/，您将看到API的浏览器呈现界面。界面中会列出所有的API端点，并且可以展开每个端点查看其详细信息、请求参数和响应数据。

通过使用rest_framework.renderers.BrowsableAPIRenderer()，您可以方便地浏览和调试API，特别是在开发和测试阶段非常有用。