В Django Rest Framework вы можете просто сгенерировать документацию:
https://www.django -rest-framework.org / themes / documenting-your-api / # documenting-your-api
from rest_framework.documentation import include_docs_urls
urlpatterns = [
...
url(r'^docs/', include_docs_urls(title='My API title'))
]
Автоматически сгенерированная документация имеет тело запроса, красиво сгенерированное из сериализатора, хорошую документацию из документации, но как добавить информацию о классах аутентификации и разрешений?
Некоторые из моих представлений на основе классов имеют пользовательские authentication_classesи permission_classes а как отобразить информацию о них?