Como documentar minha API Django automaticamente?

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.
screenshot-from-2017-01-19-22-47-16