REST - GET 返回与 POST/PUT 不同的结果

Question

在我们的项目中，可以通过 POST 或 PUT 请求发送书本结构（在 XML、JSON、..）中添加一本书。 例如，在 XML 中，书本结构如下（简化）：

<book>
    <title>My Book</title>
    <author>John Q.</author>
</book>

当这本书插入我们的后端数据库时，会自动添加一些自动生成的属性，例如创建日期、提交该书的用户 ID、标识符、...

当通过 GET 检索图书时，这些附加属性包含在图书定义中：

<book>
    <title>My Book</title>
    <author>John Q.</author>
    <info>
        <creation_date>2011...</creation_data>
        <user_id>48</user_id>
        <identifier>my_book_john_q</identifier>
    </info>
</book>

这基本上意味着新/编辑书籍（=从客户端到服务器）的 XML 方案与检索到的书籍（=从服务器到客户端）不同。 这使事情变得混乱。

一种可能是使这些附加属性在不同的 URI 中可用，例如：

http://server/books/:id/             -> returns the short version
http://server/books/:id/information/ -> returns the generated properties

这种方法的一个缺点是需要两个单独的请求来获取所有数据。

您将如何解决这种不一致？

Answer 1

这是完全正常的。 让服务器用一些额外的信息来扩充表示是没有问题的。 一个很好的例子是服务器向表示添加链接时。 在执行 PUT 时，客户端不需要将这些链接的“副本”发送到服务器。 您 GET 和 PUT 的资源表示在概念上应该是相同的，不一定逐个字节相同。

Answer 2

您没有正确使用 mimetypes。 我敢打赌，您使用的是application/xml通用 mimetype，并且您的客户知道基于端点会发生什么，对吗？

处理您的问题的正确方法是使用不同的 mimetype 对同一资源进行不同的表示。 例如，您可以将application/vnd.yourcompany.book.short+xml用于简短表示，将application/vnd.yourcompany.book+xml用于完整表示。 客户端可以使用Content-Type header 来说明他们要发送哪一个，并使用Accept header 来说明他们想要哪个。

这并不意味着客户端必须在 POST 或 PUT 中发送简短表示。 您可以将一些字段记录为可选字段，客户可以忽略它们。