（生鲜项目）20. drf文档功能简介

1.REST framework可以自动帮助我们生成接口文档。接口文档以网页的方式呈现。

自动接口文档能生成的是继承自APIView及其子类的视图。

REST framewrok生成接口文档需要coreapi库的支持。pip install coreapi

2.使用方法

from rest_framework.documentation import include_docs_urls
urlpatterns = [
...
       # 生成DRF文档的配置
       url(r'^docs/', include_docs_urls(title="慕学生鲜")),
...
]

3. 浏览器访问, 此时肯定会报错, 'AutoSchema' object has no attribute 'get_link', 原因如下, 即从3.10开始 REST就把 AutoSchema 从 coreapi 迁移到了OpenAPI 里,

如果你还仍然要使用coreapi模块, 那么就需要单独配置, settings.py

REST_FRAMEWORK = {
...
    # 解决 'AutoSchema' object has no attribute 'get_link'
    'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.coreapi.AutoSchema'
...
}

4. 再次测试, 访问成功, 界面模块如下