Django--009 DRF-Swagger文档

coreapi接口文档

• 安装库

pip install coreapi
pip install markdown

• 配置

# settings.py

# DRF配置信息
REST_FRAMEWORK = {
    # >3.10版本的DRF需要此项配置
    'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.coreapi.AutoSchema'
}

# urls.py
from rest_framework.documentation import include_docs_urls


urlpatterns = [
    ...
    path('docs/', include_docs_urls(title='测试平台接口文档', description='这是一个接口测试平台'))
]

• 访问

http://127.0.0.1:8000/docs/

swagger接口文档

• 安装库

pip install drf-yasg

• 配置

# settings.py

# 增加应用
INSTALLED_APPS = ['drf_yasg'] 

# urls.py
from django.urls import path, re_path
from drf_yasg.views import get_schema_view
from drf_yasg import openapi

schema_view = get_schema_view(
    openapi.Info(
        title="Lemon API接口文档平台",    # 必传
        default_version='v1',   # 必传
        description="这是一个美轮美奂的接口文档",
        terms_of_service="http://api.keyou.site",
        contact=openapi.Contact(email="keyou100@qq.com"),
        license=openapi.License(name="BSD License"),
    ),
    public=True,
    # permission_classes=(permissions.AllowAny,),   # 权限类
)

urlpatterns = [
    # json或yaml格式
    re_path(r'^swagger(?P<format>\.json|\.yaml)$', schema_view.without_ui(cache_timeout=0), name='schema-json'),
    # swagger
    path('swagger/', schema_view.with_ui('swagger', cache_timeout=0), name='schema-swagger-ui'),
    # redoc
    path('redoc/', schema_view.with_ui('redoc', cache_timeout=0), name='schema-redoc'),
]

• 访问

http://127.0.0.1:8000/swagger.json
http://127.0.0.1:8000/swagger
http://127.0.0.1:8000/redoc