python - django-rest-swagger 嵌套序列化器，只读字段未正确呈现

Question

我正在用 django-rest-framework 构建一个 API，我开始使用 django-rest-swagger用于文档。
我有一个带有一些 read_only 字段的嵌套序列化程序，如下所示:

# this is the nested serializer
class Nested(serializers.Serializer):
    normal_field = serializers.CharField(help_text="normal")
    readonly_field = serializers.CharField(read_only=True,
                                           help_text="readonly")

# this is the parent one
class Parent(serializers.Serializer):
    nested_field = Nested()

在生成的文档中， 中的嵌套序列化程序参数 页面的一部分是用字段数据类型呈现的，并且没有给出关于其内容的提示，它们就像其他字段一样。

现在您可以在那里看到问题，因为我想通知用户有一个只读字段不应作为嵌套数据的一部分发送，但我看不到这样做的方法。

理想的情况是在数据类型列中有一个模型描述，就像 一样。响应类 section .

有什么正确的方法吗？

Answer 1

1. 一切请使用 drf-yasg用于文档。

2. 您可以在我的存储库之一中找到它的实现 Kirpi并学习如何使用它。

3. 如果您在 3. ;有问题，让我知道。