docs

backend/api/auth/serializers.py

@@ -60,3 +60,8 @@ class LoginResponseSerializer(serializers.Serializer):
     access = serializers.CharField()
     refresh = serializers.CharField()
     user = UserResponseSerializer()
+
+
+class LogoutResponseSerializer(serializers.Serializer):
+    """Сериализатор для ответа при выходе из системы"""
+    message = serializers.CharField()

backend/api/auth/views.py

@@ -11,7 +11,8 @@ from django.contrib.auth.models import User
 from .serializers import (
     UserResponseSerializer,
     LoginRequestSerializer,
-    LoginResponseSerializer
+    LoginResponseSerializer,
+    LogoutResponseSerializer
 )
 
 from api.utils.cookies import AuthBaseViewSet
@@ -138,28 +139,33 @@ class LoginViewSet(AuthBaseViewSet):
             )
             
 class LogoutView(APIView):
-    """ViewSet для выхода из системы"""
+    """View для выхода из системы"""
+    serializer_class = LogoutResponseSerializer
     
     @extend_schema(
         summary="Выход из системы",
-        description="Эндпоинт для выхода из системы, очищает все токены и куки",
+        description="Эндпоинт для выхода из системы. Очищает JWT токены и сессионные куки.",
         responses={
             200: OpenApiResponse(
-                description="Успешный выход",
+                response=LogoutResponseSerializer,
-                response=OpenApiTypes.OBJECT,
+                description="Успешный выход из системы",
                 examples=[
                     OpenApiExample(
                         'Успешный выход',
-                        value={"message": "Logged out"}
+                        value={"message": "Успешный выход из системы"}
                     )
                 ]
             )
-        }
+        },
+        tags=['Аутентификация']
     )
     def post(self, request):
-        response = Response({'message': 'Logged out'}, status=status.HTTP_200_OK)
+        """Выход из системы с очисткой всех токенов и куки"""
+        response = Response(
+            {'message': 'Успешный выход из системы'},
+            status=status.HTTP_200_OK
+        )
         
-        # чистим куки и sessionID
         response.delete_cookie('access_token')
         response.delete_cookie('refresh_token')
         response.delete_cookie('sessionid')

backend/base/settings.py

@@ -73,7 +73,7 @@ INSTALLED_APPS = [
 # Настройки OpenAPI
 SPECTACULAR_SETTINGS = {
     'TITLE': 'AERBIM API',
-    'DESCRIPTION': 'API для работы с AERBIM',
+    'DESCRIPTION': 'AERBIM - документация по API',
     'VERSION': '1.0.0',
     'SERVE_INCLUDE_SCHEMA': False,
     'COMPONENT_SPLIT_REQUEST': True,