Esse dias fiz a seguinte pergunta para meu amigão Google, e depois de algunas sugestões, encontrei uma lib ligada a já conhecida ferramenta Swagger, chamada Django Rest Swagger. Essa ferramenta é muito simples de instalar, e podemos finalizar de forma bem documentada e automatica, todos as api’s e endpoint’s registrados em nosso projeto.
Vamos lá installar esse camarada!
Primeiro: Instale através do pip
$ pip install django-rest-swagger
Após realizar a instalação da lib com sucesso, o segundo passo é registra essa lib no nosso installed_app, (dentro do myapp/settings.py)
INSTALLED_APPS = [ ... 'rest_framework_swagger', ... ]
O passo seguinte é criar uma rota especificamente para visualização da documentação.
from django.conf.urls import url from rest_framework_swagger.views import get_swagger_view schema_view = get_swagger_view(title='Pastebin API') urlpatterns = [ url(r'^$', schema_view) ]
Finalmente, execute sua aplicação e visualize no browser.