在 django-rest-framework 和 swagger 中定义列表参数的正确方法

Question

背景

我有以下视图，附带的 swagger UI 是由 django-spectaulous 生成的：

class AllowedNameType(Enum):
    BRAND = "BRAND"
    ....

    @classmethod
    def list(cls):
        return list(map(lambda c: c.value, cls))

class GenerateCompanyNamesViewSet(viewsets.ViewSet):

    http_method_names = ["get"]
    
    def list(self, request: Request, *args, **kwargs) -> Response:
        """Generate suggested company names"""

        # query_params: dict = {}

        allowed_name_types: list[AllowedNameType] = query_params.get("allowed_name_types")
        suggestions: list[Suggestion] = ...

        return  Response(serializers.SuggestionSerializer(suggestions).data)

我想实现以下目标：

1. swagger UI 应该有一个参数 allowed_name_types ，它是 AllowedNameType< 的列表/code> 值
2. 应根据序列化器定义对输入进行验证
3. 应对 query_params 执行类型检查，以确保 allowed_name_types 的类型list[AllowedNameType]（理想情况下，allowed_name_types 实际上是一个命名参数（例如 list(..., allowed_name_types: list[AllowedNameType])

尝试解决方案

class AllowedNameTypesParamSerializer(rest_framework_serializers.Serializer):

    allowed_name_types = rest_framework_serializers.ListField(
        child=rest_framework_serializers.ChoiceField(choices=models.AllowedNameType.list()),
        required=False,
        allow_empty=True,
    )

并将以下装饰器添加到列表方法中：

@extend_schema(
        parameters=[
            OpenApiParameter(name="allowed_name_types", required=True, type=AllowedNameTypesParamSerializer),
        ],
        responses=serializers.FoodSearchAutoCompleteSerializer,
)
def list(....)

这会导致以下界面：

不幸的是：

1. swagger 组件需要一个 {"allowed_name_types 字典:...} 而不是列表，
2. 列表元素的 allowed_name_types 验证不起作用（即我可以在列表中放置一个不是来自AllowedNameType的值）
3. 奇怪的是，调用request.query_params.get('allowed_name_types') 仅返回 allowed_name_types 中的最后一个值。

帮助？

我确信我已经拥有了实现我想要的目标的所有拼图，但我不知道如何将它们拼凑在一起，以提供我所追求的记录良好的 API 和类型化验证的行为。任何帮助将不胜感激:)