Писал ли документацию к swagger
Python
Junior
Без компании
Писал ли документацию к swagger
Ответы
Да, писал. Для генерации документации API в Swagger (OpenAPI) обычно использую библиотеки типа `drf-yasg` или `drf-spectacular` для Django REST framework.
Пример с `drf-yasg`:
```
from drf_yasg import openapi
from drf_yasg.views import get_schema_view
from rest_framework import permissions
schema_view = get_schema_view(
openapi.Info(
title="API Docs",
default_version='v1',
description="API documentation",
),
public=True,
permission_classes=(permissions.AllowAny,),
)
urlpatterns = [
path('swagger/', schema_view.with_ui('swagger', cache_timeout=0)),
]
```
Документирую эндпоинты через декораторы `@swagger_auto_schema` или аннотации в классах. Также описываю модели, параметры запросов и возможные ответы.