DEV Community
·
🚀 Django REST Framework：安装与 API 文档设置
内容提要
Django REST Framework (DRF) 是构建 API 的强大工具。安装后需在 settings.py 中添加 'rest_framework'，启用可浏览 API，并安装 drf-yasg 以生成 Swagger 和 ReDoc 文档。最后，启动 Django 服务器访问文档界面。
关键要点
-
Django REST Framework (DRF) 是构建 API 的强大工具。
-
确保安装 Python（建议使用 Python 3.8 及以上）和 Django。
-
通过命令 'pip install djangorestframework' 安装 DRF。
-
在 settings.py 中的 INSTALLED_APPS 中添加 'rest_framework'。
-
DRF 默认提供可浏览的 API，确保 DEFAULT_RENDERER_CLASSES 包含 JSONRenderer 和 BrowsableAPIRenderer。
-
安装 drf-yasg 以生成 Swagger 和 ReDoc 文档。
-
更新 urls.py 以配置 Swagger 和 ReDoc 的路由。
-
启动 Django 开发服务器并访问 Swagger UI 和 ReDoc UI。
-
成功安装 DRF 并设置交互式 API 文档，方便开发者探索 API。
延伸问答
如何安装 Django REST Framework？
在终端运行命令 'pip install djangorestframework' 来安装 DRF。
如何在 Django 项目中启用可浏览的 API？
在 settings.py 中的 DEFAULT_RENDERER_CLASSES 中添加 JSONRenderer 和 BrowsableAPIRenderer。
如何生成 Swagger 和 ReDoc 文档？
安装 drf-yasg 并在 urls.py 中配置相应的路由。
启动 Django 开发服务器后，如何访问 API 文档？
访问 http://127.0.0.1:8000/swagger/ 和 http://127.0.0.1:8000/redoc/。
Django REST Framework 的主要功能是什么？
DRF 是一个强大的工具，用于构建 API，使其更易于访问和开发。
在安装 DRF 之前需要准备什么？
确保安装 Python（建议使用 Python 3.8 及以上）和 Django。
