Django Rest Framework

1.文档选择

在官网上 推荐了两种API文档方案 DRF Docs 和 Swagger 。

DRF Docs 界面预览： 官方文档 ：/

Swagger 界面预览 ： 官方文档 ： /

两个各有千秋，不过我喜欢颜值高的 DRF Docs。

官方文档安装配置十分详细哦

2.DRF 文档安装

1. 安装 module

pip install drfdocs

2.配置 module

mysite/setting.py

INSTALLED_APPS = (...'rest_framework_docs',
)

3.url 配置

mysite/urls.py

urlpatterns = [...url(r'^docs/', include('rest_framework_docs.urls')),
]

4.重写界面样式

重写是在你要使用的api 模块的下面，重新实现rest_framework_docs 下 docs.html 文档即可。

比如我的docs.html :

{% extends "rest_framework_docs/base.html" %}{% block title %}Mysite API {% endblock %}{% block style %}{% load static %}<link rel="stylesheet" href="{% static "rest_framework_docs/css/style.css" %}">
{% endblock %}{% block logo %}<a class="navbar-brand" href="#">Mysite  API Documentation</a>{% endblock %}{% block jumbotron %}<div class="jumbotron"><h1>'Mysite ' Web API</h1><h3>Documentation of the 'Mysite ' Web API.</h3></div>
{% endblock %}{% block footer %}<div class="footer">Copyright © 2016 Mysite .</div>{% endblock %}>

5.重写静态文件 css

界面中加载静态的 css 文件

(1) 配置setting.py

STATIC_URL = '/static/'

(2)实现

{% load static %}<link rel="stylesheet" href="{% static "rest_framework_docs/css/style.css" %}">

(3) 使用 先 load 后 link

效果：

项目地址 ：