Django REST Framework：何时创建超链接资源以及何时创建嵌套资源？如何发布嵌套资源？

我正在使用 Django REST 框架构建 REST Web API。事情进展顺利，但我偶然发现了嵌套资源的问题。起初，REST API 中的所有关系都是超链接的。例如，一篇文章看起来像这样：

{
    "path": "http://api.myproject.com/posts/1.json",
    "id": 1,
    "author": "http://api.myproject.com/users/broak.json",
    "image": "/images/posts/cxyUzlPo.jpg",
    "header": "Who am I?",
    "footer": "I am a champion!",
    "date": "2014-11-09 15:16",
    "likes": "http://api.myproject.com/posts/1/likes.json",
    "comments": "http://api.myproject.com/posts/1/comments.json",
    "likes_count": 0,
    "comments_count": 0
}

帖子和作者（用户）之间的关系是超链接的。当您想要创建新帖子时，您需要为特定用户指定正确的超链接 - 这很好用。

当调用帖子列表时，事情会变得低效，因为您必须为每个帖子的每个作者进行额外的 API 调用。我通过使用嵌套资源而不是超链接资源解决了这个问题，因此现在每个帖子都包含有关作者的所有信息。

{
    "path": "http://api.myproject.com/posts/1.json",
    "id": 1,
    "author": {
        "email": "[email protected] /cdn-cgi/l/email-protection"
        "username": "broak",
        "first_name: "John",
        "last_name": "Broak",
        "is_staff": False,
        "is_active": True,
        "last_login": "02-26-2016"
    },
    "image": "/images/posts/cxyUzlPo.jpg",
    "header": "Who am I?",
    "footer": "I am a champion!",
    "date": "2014-11-09 15:16",
    "likes": "http://api.myproject.com/posts/1/likes.json",
    "comments": "http://api.myproject.com/posts/1/comments.json",
    "likes_count": 0,
    "comments_count": 0
}

我的第一个问题是：您是否有指导方针，我是否应该创建嵌套数据结构或带有超链接的单独端点。

我的第二个问题是：当我使用作者作为嵌套资源并想要创建新帖子时，我不想指定有关作者的所有信息（用户名、电子邮件等）。有没有办法只使用用户的链接来进行创建/更新操作？或者修改一些内容以便用户 ID 足以填写此字段？

如果我正确理解您的问题，您希望在检索数据时扩展作者，并且只想在更新和创建时发送 ID 或 URL。

1#这与任何指导方针无关，完全取决于您对如何进行操作的要求api将要被使用。

2#所以你需要延长你的UserSerializer并覆盖to_internal_value。示例代码可能看起来像

class MyCustomSerializer(UserSerializer):
    def to_internal_value(self, data):
        # data must be valid user-detail url
        return serializers.HyperLinkedRelatedField(queryset=User.objects.all(), view_name='user-detail').to_internal_value(data)

Notice您必须有一个用于用户详细信息的端点才能使用 HyperLinkedRelatedField。

所以如果你想能够发送ID那么示例代码可能看起来像

class MyCustomSerializer(UserSerializer):
    # data must be valid user id
    def to_internal_value(self, data):
        return serializers.PrimaryKeyRelatedField(queryset=User.objects.all()).to_internal_value(data)

但是我想在发送ForeignKey字段时保持一致性POST/PUT/PATCH。 （始终为 URL 或 ID）。

然后在你的代码中使用它，例如

class PostSerializer(serializers.HyperlinkedModelSerializer):
    author = MyCustomSerializer()

    class Meta:
        model = Post

请参阅有关的文档可写嵌套序列化器 http://www.django-rest-framework.org/api-guide/relations/#writable-nested-serializers to POST在嵌套资源上。