Расширение_schema drf-Spectular не работает

Я недавно перешел из drf-yasg к drf-spectacular в моем проекте, но @extend_schema декоратор, похоже, не добавляет никакой информации в мою сгенерированную схему:

  • views.py
      class SearchView(GenericViewSet):
    serializer_class = serializers.CriterionSerializer
    
    
    @extend_schema(
        methods=['post'],
        summary="Find patients according to search query.",
        description="Search for patients related to Documents found with the given query.",
        request=PolymorphicProxySerializer(
            component_name='Criterion',
            serializers=[
                    serializers.TextCriterionSerializer, serializers.GroupCriterionSerializer,
            ],
            resource_type_field_name='type',
        )
    )
    @action(detail=False, methods=['POST'])
    def fetch(self, request):
        serializer = serializers.CriterionSerializer(data=request.data)
        if not serializer.is_valid(raise_exception=True):
            return Response(serializer.errors, status=400)
        
        return serializers.PatientDocumentSerializer(
            serializer.create(serializer.validated_data).fetch(), context={'request': request},
            many=True
        ).data

И вот соответствующая часть сгенерированной схемы:

       /search/fetch/:
    post:
      operationId: searchFetchCreate
      description: ''
      tags:
      - search
      security:
      - jwtAuth: []
      responses:
        '200':
          description: No response body

Вот дополнительная информация для контекста:

  • urls.py
      router = routers.DefaultRouter()
router.register(r'search', views.SearchView, basename='search')

urlpatterns = [
    path('', include(router.urls), name="search"),
]
  • SPECTUACULAR_SETTINGS
      SPECTACULAR_SETTINGS = {
    'TITLE': 'API',
    'VERSION': '1.0.0',
    'CAMELIZE_NAMES': True,
    'COMPONENT_SPLIT_REQUEST': True,
    'SERVE_PERMISSIONS': ['rest_framework.permissions.AllowAny'],
    'SWAGGER_UI_SETTINGS': {
        'deepLinking': True,
        'filter': True,
        'displayRequestDuration': True,
        'syntaxHighlight.activate': True,
        'syntaxHighlight.theme': 'monokai',
    },
}
  • Версии:
      $ pip3 show django drf-spectacular
Name: Django
Version: 2.2.13
[...]
---
Name: drf-spectacular
Version: 0.17.1
[...]

1 ответ

Решение

Это произошло из-за methods=['post'], вместо methods=['POST'], внутри @extend_schema.

Другие вопросы по тегам