0

我正在使用 drf-spectacular 为 django 生成 OpenAPI 模式。因为我没有使用序列化程序，所以我在extend_schema装饰器中定义了所有内容。现在我的问题是，是否可以手动定义组件架构。

这是我的 api 视图的示例：

from rest_framework.decorators import api_view
from drf_spectacular.utils import (extend_schema, OpenApiExample)
from drf_spectacular.types import OpenApiTypes
from rest_framework.response import Response

@extend_schema(
    examples=[OpenApiExample(
        value=[
            {'title': 'A title'},
            {'title': 'Another title'},
        ],
    )],
    responses={
       200: OpenApiTypes.OBJECT
    }
)
@api_view(['GET'])
def list_articles(request):
    return Response([{'title': 'Test1'}, {'title': 'Test2'}])

并且相应的组件显示为空（例如在swagger中）：

swagger-ui 空组件示例

这是文档中的定义，但我无法弄清楚如何使用 drf-spectacular 来实现它。

4

1 回答 1

2

OpenApiTypes.OBJECT意味着响应对象可以有任意数量的字段。当然，Swagger UI 无法提前知道这些字段，因此它会显示{}，这可能不直观，但它是正确的。

你想要的是给你的回应一些结构。壮观的一切都围绕着序列化器/组件。如果您不想使用显式序列化器，可以使用inline_serializer创建隐式序列化器

from drf_spectacular.utils import extend_schema, OpenApiExample, inline_serializer

@extend_schema(
    examples=[OpenApiExample(
        value=[
            {'title': 'A title'},
            {'title': 'Another title'},
        ],
    )],
    responses={
       200: inline_serializer(
           name='Article',
           fields={
               'title': serializers.CharField(),
           }
       )
    }
)
@api_view(['GET'])
def list_articles(request):
    pass
于 2021-11-01T15:25:53.337 回答