django - 使用 drf-spectacular 为 django API 定义组件模式

Question

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

这是我的 api View 的示例:

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 中):

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

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