使用 drf-spectaulous 为 django API 定义组件架构

Question

我正在使用 drf-spectaulous 为 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 中）：

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

Answer 1

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